Skip to main content
GET
Get a party's partner-terms consent state
Requires scope: manage:parties — see Required scopes. Returns one status and, while acceptance is outstanding, one consentUrl — covering every partner the party is onboarding to. You never deal with partners individually.
REQUIRED always comes with a consentUrl. That pairing is guaranteed — if the platform reports terms outstanding without a link, you get a retryable 503 instead of a REQUIRED you can’t act on.
Each call returns the current state and link, so an expiring or re-issued link is never stale. If you’d rather poll the plain party read, partnerTermsStatus on Get party details carries the same value.
ACCEPTED is not the end. It is evaluated against the terms active now, so enabling a new partner — or a partner publishing a new terms version — supersedes what was accepted and moves the party back to REQUIRED. Re-read it; don’t record it as a done milestone.

Errors

A 503 here never means “nothing outstanding”. The endpoint fails closed rather than guessing, so treating it as NOT_REQUIRED would skip the gate. See Partner-terms consent.

Authorizations

Path Parameters

partyId
string<uuid>
required

Unique party identifier

Response

The party's consent state

success
boolean

Indicates whether the request was successful

result
object

A party's partner-terms consent state, current as of the call.