# List physical presences

> GET /physical-nexus

Source: https://docs.trykintsugi.com/reference/2026-07-21/list-physical-presences

GET /physical-nexus

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.

Category: Physical nexus

Query parameters:
orderBy (PublicPhysicalNexusSortEnum) - Field to sort by. Omit to page in the default country, then state, then category order.
  allowed values: countryCode, stateCode, category, startDate, endDate, createdAt
order (PublicPhysicalNexusSortOrder) - Sort direction. Applies only when `orderBy` is set.
  allowed values: asc, desc
countryCode (string) - Comma-separated ISO 3166-1 alpha-2 country codes. Matches any listed value.
stateCode (string) - Comma-separated state or province codes. Matches any listed value.
limit (integer) - Maximum number of items to return.
cursor (string) - Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.

Response fields:
items (PhysicalNexus[], required) - Physical nexus rows on this page.
  id (string, required) - Opaque unique identifier for this physical nexus.
  organizationId (string, required) - Organization this physical nexus belongs to. Always present so a portfolio list that spans organizations stays unambiguous.
  organizationName (string) - Display name of the owning organization. `null` if the name could not be loaded.
  organizationHasTransactions (boolean, required) - Whether the owning organization has any transactions. Editing a closed presence would move a date that nexus was already calculated against, so clients disable editing when this is `true` and `endDate` is set.
  countryCode (string, required) - ISO 3166-1 alpha-2 country of the jurisdiction.
  stateCode (string, required) - State or province code within `countryCode`. `FD` for a federal jurisdiction.
  category (PublicPhysicalNexusCategoryEnum, required) - Kind of physical presence this record describes. Which categories a jurisdiction accepts varies; get the catalog from `GET /physical-nexus/categories`. Ignore unrecognized values.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt