Resources

Publish approvals

Every Publish approvals endpoint, with the scope it enforces, the body it takes, a response you can read, and the refusals it can return.

Fetch one publish approval.

get/organizations/{organization}/publish-approvals/{id}

Scope: passports:read
Idempotency-Key: Not accepted
Returns: 200

Path parameters

organizationstringRequired

The organization this request acts for. The credential must hold a grant for it.

idstringRequired

The identifier of the resource. Treat it as an opaque string.

Errors

Every refusal this endpoint can return, with the status it arrives with.

Request

curl "https://passportcraft.com/api/v1/organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/publish-approvals/7d3f1a92-64c8-4b07-8e5a-1c9b2d4e6f80" \
  -H "Authorization: Bearer $PASSPORTCRAFT_API_KEY"

Response · 200

{
  "object": "publish_approval",
  "id": "7d3f1a92-64c8-4b07-8e5a-1c9b2d4e6f80",
  "name": "organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/publish-approvals/7d3f1a92-64c8-4b07-8e5a-1c9b2d4e6f80",
  "organization_id": "8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2",
  "passport_id": "2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41",
  "status": "pending",
  "review_url": "https://passportcraft.com/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41/edit",
  "requested_at": "2026-08-17T09:12:04.881Z",
  "expires_at": "2026-08-24T09:12:04.881Z",
  "decided_at": null,
  "livemode": true
}

GET /organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/publish-approvals/7d3f1a92-64c8-4b07-8e5a-1c9b2d4e6f80