Commet
  • Pricing
Log InTry out
Create offer POSTDelete offer DELETEGet offer GETList offers GETUpdate offer PATCH
System status
DocumentationKnowledge BaseBuild with AIAPI ReferenceWebhooks

Get offer

Retrieve a canonical offer by its public ID.

GET
/offers/{id}

Retrieve a canonical offer by its public ID.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/offers/string"
{  "id": "string",  "name": "string",  "purpose": "introductory",  "planPriceIds": [    "string"  ],  "phases": [    {      "type": "free_trial",      "durationDays": 1    }  ],  "metadata": {    "property1": null,    "property2": null  },  "startsAt": "2019-08-24T14:15:22Z",  "endsAt": "2019-08-24T14:15:22Z",  "active": true,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "object": "offer",  "livemode": true}
{  "error": {    "type": "string",    "code": "string",    "message": "string",    "param": "string",    "details": null,    "doc_url": "string"  }}
{  "error": {    "type": "string",    "code": "string",    "message": "string",    "param": "string",    "details": null,    "doc_url": "string"  }}
{  "error": {    "type": "string",    "code": "string",    "message": "string",    "param": "string",    "details": null,    "doc_url": "string"  }}
{  "error": {    "type": "string",    "code": "string",    "message": "string",    "param": "string",    "details": null,    "doc_url": "string"  }}
{  "error": {    "type": "string",    "code": "string",    "message": "string",    "param": "string",    "details": null,    "doc_url": "string"  }}
{  "error": {    "type": "string",    "code": "string",    "message": "string",    "param": "string",    "details": null,    "doc_url": "string"  }}

Delete offer DELETE

Soft-delete an offer. Existing applications and their accepted terms remain available for billing and audit.

List offers GET

List the organization's canonical introductory and promotional offers.