Docs

Get Advance Request

GET /advanceRequests/{advanceRequestId}

GET/advanceRequests/{advanceRequestId}

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <api-key>OptionalYour API key. Pass it as the Bearer token on every request.
Event tokenx-Event-TokenOptionalRun **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually.

Returns detailed information for a single advance request. Compared to the list endpoint, this response includes the full request template definition — including all its properties with labels and response types — making it suitable for rendering an approval detail view.

Event scoping: These endpoints do not include {eventId} in the URL. The event is determined automatically from your x-Event-Token — the API uses it to know which event's data to return. Ensure you have a valid event token before making any calls in this folder.

Path Parameters

FieldTypeRequiredDescription
advanceRequestIdGuidRequiredThe ID of the advance request to retrieve.

Response Fields

FieldTypeDescription
idGuidThe advance request's unique ID.
advanceApprovedbool \| nullnull
resourceApprovedbool \| nullnull
procurementIdGuid \| nullnull
advanceobjectParent advance with collaborator, area, and activity.
moduleobjectThe advance module instance (id, label, icon from its template).
moduleTemplateBlockobjectThe specific block (id).
requestTemplateobjectFull request template definition including `isAssetRequest`, approval flags, and all property definitions with labels and response types.
assetobject \| nullnull
propertiesarrayCurrent property values for this request.

Example Response

{
	"id": "req-guid-001",
	"advanceApproved": true,
	"resourceApproved": null,
	"procurementId": null,
	"advance": {
		"id": "adv-guid-001",
		"name": "Stage A Advance",
		"collaborator": { "id": "collab-guid-001", "name": "Stage Productions Inc." },
		"area": { "id": "area-guid-001", "name": "Main Stage" },
		"activity": null
	},
	"module": { "id": "advmod-guid-001", "label": "Audio", "icon": "speaker" },
	"moduleTemplateBlock": { "id": "block-guid-001" },
	"requestTemplate": {
		"id": "rtmpl-guid-001",
		"name": "PA System",
		"isAssetRequest": true,
		"isAdvanceApproved": false,
		"isResourceApproved": false,
		"properties": [
			{
				"id": "tprop-guid-001",
				"label": "Number of Channels",
				"responseType": "Number"
			}
		]
	},
	"asset": null,
	"properties": [{ "id": "prop-guid-001", "templatePropertyId": "tprop-guid-001", "value": "12" }]
}

Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Missing or invalid token.
NOT_FOUND404Advance request not found for this event.