Entitlements API

TypeScript
Python
Go
cURL

await fetch("https://api.accend.now/v1/entitlements/check", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ACCEND_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID()
  },
  body: JSON.stringify({ customerId: "cus_123", productId: "prod_123" })
});

requests.post(
    "https://api.accend.now/v1/entitlements/check",
    headers={
        "Authorization": f"Bearer {os.environ['ACCEND_API_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={"customerId": "cus_123", "productId": "prod_123"},
)

payload := strings.NewReader(`{"customerId":"cus_123","productId":"prod_123"}`)
req, _ := http.NewRequest(http.MethodPost, "https://api.accend.now/v1/entitlements/check", payload)
req.Header.Set("Authorization", "Bearer "+os.Getenv("ACCEND_API_KEY"))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Idempotency-Key", "req_123")

curl -X POST "https://api.accend.now/v1/entitlements/check" \
  -H "Authorization: Bearer $ACCEND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"customerId":"cus_123","productId":"prod_123"}'

Endpoints

POST /v1/entitlements/check
GET /v1/customers/{customerId}/entitlements

POST /v1/entitlements/check

Scopes: write

{
  "customerId": "cus_abc123",
  "productId": "prod_abc123"
}

Response 200 (allowed)

{
  "data": {
    "allowed": true,
    "reason": "active"
  },
  "error": null,
  "success": true
}

Response 200 (denied)

{
  "data": {
    "allowed": false,
    "reason": "expired"
  },
  "error": null,
  "success": true
}

Reason values:

active
no_entitlement
expired
past_due
revoked

GET /v1/customers//entitlements

Scopes: read Response 200

{
  "data": {
    "items": [
      {
        "id": "ent_abc123",
        "productId": "prod_abc123",
        "status": "active",
        "source": "subscription",
        "startsAt": "2025-01-15T00:00:00Z",
        "endsAt": "2025-02-15T00:00:00Z"
      }
    ],
    "hasMore": false,
    "nextCursor": null
  },
  "error": null,
  "success": true
}

​Entitlements API

​Endpoints

​POST /v1/entitlements/check

​GET /v1/customers//entitlements

Entitlements API

Endpoints

POST /v1/entitlements/check

GET /v1/customers//entitlements