Skip to main content
GET
/
v1
/
benefits
/
{id}
Get Benefit
curl --request GET \
  --url https://api.spairehq.com/v1/benefits/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "modified_at": "2023-11-07T05:31:56Z",
  "type": "<string>",
  "description": "<string>",
  "selectable": true,
  "deletable": true,
  "organization_id": "<string>",
  "metadata": {},
  "properties": {
    "note": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.spairehq.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

You can generate a Personal Access Token from your settings.

Path Parameters

​
id
string<uuid4>
required

The benefit ID.

Response

Successful Response

A benefit of type custom.

Use it to grant any kind of benefit that doesn't fit in the other types.

​
id
string<uuid4>
required

The ID of the benefit.

​
created_at
string<date-time>
required

Creation timestamp of the object.

​
modified_at
string<date-time> | null
required

Last modification timestamp of the object.

​
type
string
required
Allowed value: "custom"
​
description
string
required

The description of the benefit.

​
selectable
boolean
required

Whether the benefit is selectable when creating a product.

​
deletable
boolean
required

Whether the benefit is deletable.

​
organization_id
string<uuid4>
required

The ID of the organization owning the benefit.

​
metadata
object
required
​
properties
BenefitCustomProperties · object
required

Properties for a benefit of type custom.