Skip to content

List bundle links

GET
/developer/organizations/{organizationId}/bundles/{bundleId}/links
curl --request GET \
--url 'https://qinto-api.blotout.io/developer/organizations/9c1d2b34-5e67-4f89-a0b1-2c3d4e5f6a7b/bundles/2b7e4d10-8a3c-4f56-9e21-7c0d5b8f3a64/links?cursorCreatedAt=2026-11-05T12%3A00%3A00.000Z&cursorId=2b7e4d10-8a3c-4f56-9e21-7c0d5b8f3a64&limit=50' \
--header 'Authorization: Bearer <token>'

Lists one page of a bundle’s links, newest first, revoked ones included. A Draft or a public bundle has none.

Required permissions

  • None beyond a valid token; requires an OAuth token with the developer or bundles scope, for an owner of the addressed organization or a member with the bundles finance area and all apps
organizationId
required

Unique id (UUID) of the organization that owns the bundles, as listed by GET /me under organizations.

string format: uuid

Example

9c1d2b34-5e67-4f89-a0b1-2c3d4e5f6a7b

Unique id (UUID) of the organization that owns the bundles, as listed by GET /me under organizations.

bundleId
required

Unique id (UUID) of the bundle, as returned by the create and list operations.

string format: uuid

Example

2b7e4d10-8a3c-4f56-9e21-7c0d5b8f3a64

Unique id (UUID) of the bundle, as returned by the create and list operations.

cursorCreatedAt

The nextCursor.createdAt of the previous page.

string format: date-time

Example

2026-11-05T12:00:00.000Z

The nextCursor.createdAt of the previous page.

cursorId

The nextCursor.id of the previous page.

string

Example

2b7e4d10-8a3c-4f56-9e21-7c0d5b8f3a64

The nextCursor.id of the previous page.

limit

Page size, 1–200 (default 50).

integer
>= 1 <= 200

Example

50

Page size, 1–200 (default 50).

The bundle’s links.

Media typeapplication/json
object
links
required

One page of the bundle’s links, newest first, revoked ones included.

Array<object>

A link that offers a private bundle to whoever holds it.

object
linkId
required

Server-assigned unique id of the link.

string
bundleId
required

Id of the bundle the link belongs to.

string
label
required

What the developer calls the link.

string
limit
required
Any of:

How many teams can buy through the link.

integer
token
required

The token in the link’s URL. It stays readable, so the link can be copied again at any time.

string
url
required

The URL to send to a team.

string
useCount
required

How many teams have bought through the link.

integer
revokedAt
required

When the link was revoked, as an ISO 8601 UTC timestamp. Null while it is not revoked.

string | null format: date-time
createdByUserId
required

Id of the user who created the link. Null once that user is deleted.

string | null
createdAt
required

When the link was created, as an ISO 8601 UTC timestamp.

string format: date-time
nextCursor
required

Pass both fields as cursorCreatedAt / cursorId for the next page; null on the last page.

object
createdAt
required

Creation instant of the last listed link.

string
id
required

Id of the last listed link.

string

Example

{
"links": [
{
"linkId": "5d2c8e71-3f4a-4b90-8c16-e7a9d0b2f345",
"bundleId": "2b7e4d10-8a3c-4f56-9e21-7c0d5b8f3a64",
"label": "Acme partner offer",
"limit": 25,
"token": "3f9a1c7e5b2d4806a1e3c5f7092b4d6e8f0a1c3e5b7d9f1a2c4e6b8d0f2a4c6e",
"url": "https://platform.blotout.io/bundles/link?token=3f9a1c7e5b2d4806a1e3c5f7092b4d6e8f0a1c3e5b7d9f1a2c4e6b8d0f2a4c6e",
"useCount": 0,
"revokedAt": "2026-11-05T00:00:00.000Z",
"createdByUserId": "c7d1e2f3-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
"createdAt": "2026-11-05T00:00:00.000Z"
}
],
"nextCursor": {
"createdAt": "2026-11-05T12:00:00.000Z",
"id": "5d2c8e71-3f4a-4b90-8c16-e7a9d0b2f345"
}
}

invalid_params — A path parameter failed validation (for example a malformed UUID); details pinpoints the offending parameter. invalid_body — The JSON body is unparseable or failed schema validation; details pinpoints the offending fields when the body could be parsed.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: invalid_params invalid_body
details

Field-level validation errors: a tree keyed by input property, each node carrying an errors array of human-readable messages. Render it to help the caller correct the request.

object
key
additional properties

Example

{
"error": "invalid_params",
"details": {
"errors": [],
"properties": {
"teamId": {
"errors": [
"Invalid UUID"
]
}
}
}
}

unauthenticated — The Authorization: Bearer token is missing, malformed, or no longer valid. Generate a team API token or obtain a new OAuth access token.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: unauthenticated

Example

{
"error": "unauthenticated"
}

forbidden — The bearer credential lacks the required permission or belongs to another team, or its user lacks the organization role a developer operation needs. Update its policies, use a credential bound to the addressed team, or ask an organization owner for the role; message states the reason when one is known. bundles_scope_required — The bearer credential has neither the developer nor the bundles scope, so it reaches no bundle operation whatever the role of its user. Authorize again to get a token with one of them.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: forbidden bundles_scope_required
message

Human-readable reason for this specific failure, intended for display — do not parse it programmatically.

string

Example

{
"error": "forbidden",
"message": "The Cloudflare API token is invalid or expired."
}

not_found — The addressed resource does not exist within this team; check the id and retry.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: not_found

Example

{
"error": "not_found"
}

internal — Unexpected server error. Nothing is guaranteed to have been persisted; idempotent operations are safe to retry.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: internal

Example

{
"error": "internal"
}