DocumentationTypeship CLITypeship MCPTypeship SDKsAPI Reference
Console
Deliveries

List Deliveries

GET
/deliveries

Authorization

apiKey
AuthorizationBearer <token>

Organization API key from the console (ak_...), or an OAuth access token with user:org:read, the organization selected during consent, and the capability required by the operation.

In: header

Query Parameters

limit?integer

Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400.

Range1 <= value <= 100
Default20
cursor?string

Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests.

Match^[A-Za-z0-9_-]+$
Length1 <= length <= 2048
target_id?string

Only Deliveries of this Target.

Match^tgt_[a-z0-9]{16}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/deliveries"
{  "object": "list",  "data": [    {      "id": "dlv_4q8m2v7k1p9d5h6c",      "object": "delivery",      "target_id": "tgt_5m8q2v7k1p9d4h6c",      "type": "repository",      "repository": {        "provider": "github",        "identifier": "parcel-example/parcel-client",        "directory": null,        "package_name": "parcel-client",        "module_path": null,        "publish_on_merge": false      },      "status": "active",      "issues": [],      "required_checks": [        "Typeship Release"      ],      "last_event": null,      "created_at": "2026-09-23T08:00:00Z",      "updated_at": "2026-09-23T08:00:00Z"    }  ],  "has_more": false,  "next_cursor": null,  "request_id": "req_3k8m1v6q9p2d7h4c"}

Retry publishing an exact release POST

Retries publishing the specified release through its repository workflow. Uses that release's version and accepted commit, even if a newer Draft or release exists. A `502` response means the repository publishing workflow could not be dispatched.

Get a Delivery GET

Returns the configured repository or hosted MCP Delivery for a Target. A Delivery in another organization returns 404 not_found.