Download signed contract document
Streams the completed (signed) PDF for a contract request through UrbanPayX,
without exposing the underlying signing-provider URL.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Downloads the completed (signed) PDF for a contract request. UrbanPayX streams the file back through its own infrastructure, so the underlying signing-provider URL is never exposed to the caller. The contract request must already be completed before its document is available.
Authentication & access
- Requires a client API token:
Authorization: Bearer <token>. - The caller must hold the
contracts.requests.readpermission and have the OWNER, OPERATIONS, or DEVELOPER role. - Contract signing must be enabled for the client. If it is disabled the request returns
403.
Path parameters
| Parameter | In | Description |
|---|---|---|
request_id | path | The ID of the contract request whose signed document you want to download. Must belong to your client. |
Preconditions
The contract request must be in the COMPLETED state (all signers have finished). A request that is still in progress, or that has no associated completed submission, returns 409.
Response
200 — Returns the signed contract document as a binary PDF stream. The response is served with Content-Disposition: inline and a filename of contract-<request_id>.pdf. The content type comes from the signing provider and is normally application/pdf.
Error responses
| Status | When |
|---|---|
403 | Contract signing is disabled for this client |
404 | No contract request with this request_id exists under your client |
409 | The contract is not completed yet (request is not in COMPLETED status, or has no completed document) |
502 | The signed document is not yet available from the signing provider, or fetching it failed |
503 | The signing provider is temporarily unavailable, please retry later |
Standard 401 (authentication), 403 (insufficient permission or role), and 429 (rate limit) responses apply to every endpoint and are documented in the Error reference.