List physical presences
Returns a keyset page of the physical presences recorded for organizations your credential owns. Defaults to country, then state, then category order; sort with orderBy/order, and omit orderBy to page in that default order. Send Organization-Id, Connection-Id, or Entity-Id to narrow to one organization. A cursor is valid only for the sort, filters and organization scope that issued it.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Narrow the request to one organization (Organization-Id selector).
Narrow the request to a connection's organization.
Narrow the request to a platform entity's organization.
Optional source to disambiguate an Entity-Id.
Query
Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.
/physical-nexus?orderBy=<orderBy>&order=<order>&countryCode=<countryCode>Field to sort by. Omit to page in the default country, then state, then category order.
countryCodestateCodecategorystartDateendDatecreatedAtSort direction. Applies only when orderBy is set.
ascdescComma-separated ISO 3166-1 alpha-2 country codes. Matches any listed value.
Comma-separated state or province codes. Matches any listed value.
Maximum number of items to return.
Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.
Response
Physical nexus rows on this page.
Opaque cursor for the next page. null on the last page. Send it back as cursor; do not parse it.
Opaque cursor for the previous page. null on the first page. Send it back as cursor; do not parse it.
Whether a page exists after this one.
Whether a page exists before this one.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.