List authorization invitations | Kuudo API Documentation

{
  "invitations": [
    {
      "id": "string",
      "provider": "amazon_ads",
      "origin": "invited",
      "externalCustomerReference": "string",
      "options": {
        "region": "na",
        "sellingPartnerType": "seller",
        "marketplace": "ca"
      },
      "status": "pending",
      "authorizationId": 1,
      "createdAt": "2024-01-15T09:30:00Z",
      "expiresAt": "2024-01-15T09:30:00Z",
      "completedAt": "2024-01-15T09:30:00Z",
      "providerMetadata": {
        "id": "string",
        "provider": "amazon_ads",
        "mode": "string",
        "status": "string",
        "account_summary": {
          "display_name": "string",
          "name": "string",
          "email": "string",
          "selling_partner_id": "string",
          "selling_partner_type": "seller",
          "authorization_marketplace": "ca",
          "amazon_user_id": "string",
          "marketplaces": [
            {}
          ],
          "profiles": [
            {}
          ]
        },
        "created_at": "2024-01-15T09:30:00Z",
        "updated_at": "2024-01-15T09:30:00Z",
        "region": "string"
      }
    }
  ],
  "nextCursor": "string"
}

Development contract: availability requires the invitation feature release. API-key-derived JWT only; other OAuth bearers are rejected. Machine visibility is limited to the initiating M2M client. Follow nextCursor until null. Reads never include authorizationUrl.

Requires every scope: authorization-invitations:read.

Authentication

AuthorizationBearer

JWT returned by POST /api/auth/token-exchange. Amazon and authorization invitations require API-key-derived tokens.

Query parameters

cursorstringOptional1-200 characters

cursor

limitintegerOptional1-50

limit

statusenumOptional

status

Allowed values:

externalCustomerReferencestringOptional1-200 characters

externalCustomerReference

Response

Success

invitationslist of objects

nextCursorstring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error