Partnerships

List Partnerships for administration

Changed on

Delegated Aura access tokens require partnerships:read; missing scope returns 403 FORBIDDEN. Lists active Partnerships for authenticated administrators.

Results use bounded keyset cursor pagination in fixed created descending, then Partnership ID descending order. Page sizes are clamped to 1–100, with a default of 21. The returned searchAfter value is a JSON-encoded [created RFC3339 timestamp, Partnership ID] cursor; it is omitted on the terminal page and should be sent with the same filters for the next page.

Optional partyId, memberUserId, and listingSourceId filters are exact object-ID matches and are combined when supplied. Each result is a safe summary containing the Partnership ID, Party ID/immutable slug/name, member count, ListingSource-grant count, and creation/update timestamps. Member identities, grant identities, Party contact data, persistence versions, provider credentials, webhook secrets, and crawler-local configuration are never returned. Responses always use Cache-Control: no-store.

get/api/v1/admin/partnerships

Request

  • Base URL: https://api.stage.aura-historia.com
  • URL: https://api.stage.aura-historia.com/api/v1/admin/partnerships
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Query parameters

partyIdstring

Optional exact Party ID filter.

memberUserIdstring

Optional exact member User ID filter.

listingSourceIdstring

Optional exact ListingSource grant ID filter.

searchAfterstring

JSON-encoded [created RFC3339 timestamp, Partnership ID] cursor returned by the previous page.

sizeinteger

Number of Partnership summaries requested per page. The server clamps values to 1–100.

Response

Partnership summaries returned successfully.

sizeinteger required

Number of items returned in the current page.

searchAfterstring[]

Partnership cursor for the next page, omitted when no more results are available.

Example response

{
  "size": 21,
  "searchAfter": [
    "2026-09-04T12:00:00Z",
    "psh_3q65ndcw7wfxqswjtrv1kfhwd1"
  ]
}

Changes

  • 927a680d096bRevision changes
    • breaking

      the response property's min was decreased from 1.00 to 0.00 for the response status

  • 999eda3fdd63Revision changes
    • breaking

      the // response's property format changed from uuid to no format for status

    • breaking

      the /// response's property format changed from uuid to no format for status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • info

      for the query request parameter listingSourceId, the format was generalized from uuid to no format

    • info

      for the query request parameter memberUserId, the format was generalized from uuid to no format

    • info

      for the query request parameter partyId, the format was generalized from uuid to no format

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status