Get a purchase request by code

GET 
/purchase-requests/:code

Retrieves a specific purchase request by its unique code with optional includes. Codes that do not match a purchase request resolve through an exact purchase ORDER code match to the owning purchase request, so detail routes can be entered with either code. Comments are not exposed via a dedicated endpoint: set with_activities=true to receive them alongside system events in the activities field.

Permissions: requires purchase-requests:read plus object-level visibility; purchase requests the caller may not view return 404 to avoid an existence oracle.

Request

Responses

200

Purchase request details

400

Bad request - code missing

401

Unauthorized

403

Forbidden - request denied by authorization, or blocked by the API firewall

404

Purchase request not found

429

Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying

Response Headers

Retry-After

Delay in seconds a client must wait before retrying the request

500

Internal server error