POST
/
exemption-certificates
curl --request POST \
  --url https://base_url/api/v1/exemption-certificates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "expiring_at": "2023-12-25",
  "issued_at": "2023-12-25",
  "country": "US",
  "jurisdiction": "<string>",
  "type": "PURPOSE_WHOLESALE",
  "customer_id": "<string>",
  "file_id": "<string>"
}'
{
  "data": {
    "id": "<string>",
    "expiring_at": "2023-12-25",
    "issued_at": "2023-12-25",
    "country": "US",
    "jurisdiction": "<string>",
    "status": "INVALID",
    "verification_status": "PENDING_VERIFICATION",
    "type": "PURPOSE_WHOLESALE",
    "customer_id": "<string>",
    "file_id": "<string>",
    "created_at": 1727284490
  },
  "message": "Successfully created exemption certificate."
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
issued_at
string
required

ISO 8601 formatted string indicating the date when this exemption certificate was issued.

​
country
string
required

ISO 3166 2-letter country code. Ex: US, IN, GB.

Example:

"US"

​
jurisdiction
string
required

A string representing the jurisdiction: either a 2-letter state code (ISO 3166-2 suffix), 'SST', or 'MTC', depending on the exemption certificate details.

​
type
enum<string>
required

Type of the exemption certificate. Request additional types from the Commenda team as required.

Available options:
PURPOSE_WHOLESALE,
ENTITY_TYPE_NONPROFIT
​
customer_id
string
required

The unique identifier of the customer associated with this exemption certificate.

​
file_id
string
required

Identifier of the file to use as the exemption certificate for this customer. Returned from the POST /files endpoint once the file is uploaded.

​
expiring_at
string

ISO 8601 formatted date string indicating the date when this exemption certificate will expire. This is an optional field as some certificates might be valid indefinitely.

Response

200
application/json
Successful exemption certificate creation
​
data
object
​
message
string
Example:

"Successfully created exemption certificate."

Exemption CertificatesGet exemption certificate