Skip to main content
GET
/
addons
/
{id}
Retrieve addon
curl --request GET \
  --url https://api.piriod.com/addons/{id}/ \
  --header 'Authorization: <api-key>' \
  --header 'x-simple-workspace: <x-simple-workspace>'
{
  "name": "<string>",
  "description": "<string>",
  "currency": "<string>",
  "amount": 123,
  "id": "<string>",
  "sku": "<string>",
  "apply_scheme": "one_time",
  "duration_times": 123,
  "unit_label": "<string>",
  "status": "active",
  "archived": "2023-11-07T05:31:56Z",
  "created": "2023-11-07T05:31:56Z",
  "updated": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Use header Authorization: Token <api_token>. API tokens are obtained from the Piriod dashboard.

Headers

​
x-simple-workspace
string
required

Workspace (account) identifier. Required for every request.

​
x-piriod-test-mode
boolean
default:false

Whether to operate against test-mode data. Defaults to false.

Path Parameters

​
id
string
required

Resource identifier.

Response

The addon.

​
name
string
required
Maximum string length: 56
​
description
string
required
Maximum string length: 256
​
currency
string
required
​
amount
number
required
​
id
string
read-only
​
sku
string | null
Maximum string length: 32
​
apply_scheme
enum<string>
default:one_time
Available options:
one_time,
recurring
​
duration_times
integer | null
​
unit_label
string | null
Maximum string length: 4
​
status
enum<string>
default:active
Available options:
active,
archived
​
archived
string<date-time> | null
read-only
​
created
string<date-time>
read-only
​
updated
string<date-time>
read-only