GraphQL API
Organization API
Organization guide
Getting started
Send your first authenticated request to the PackCloud GraphQL API.
Choose the right schema
Use the Organization API for commercial and configuration data. Use the Warehouse API for daily warehouse operations. A request is always scoped by the identifier in its endpoint.
Organizationhttps://api.pack.cloud/v1/organizations/{organizationId}/graphql
Warehousehttps://api.pack.cloud/v1/warehouses/{warehouseId}/graphql
How a GraphQL request works
GraphQL uses one endpoint per schema. Your request contains an operation that names the fields you need; the response mirrors that field structure.
OperationA query reads data; a mutation changes data.
FieldsSelect only the response fields your integration needs.
Type markersSquare brackets mean a list; an exclamation mark means non-null.
VariablesPass IDs, filters, and input separately from the operation text.
ConnectionA paginated list with edges, nodes, cursors, and pageInfo.
Start small. Select one or two fields, confirm the response, then add nested fields as your integration needs them.
Make a request
Replace the path identifier and token, then send a JSON POST request.
curl --request POST "https://api.pack.cloud/v1/organizations/{organizationId}/graphql" \
--header "Authorization: Bearer $PACKCLOUD_TOKEN" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data '{"query":"query FirstPage { orders(first: 1) { edges { node { id } } } }"}'GraphQL responses return JSON. A successful request can still contain an errors array, so inspect the response body as well as the HTTP status.