Skip to main content
get with kind: "advertiser_access" answers three questions about one advertiser in your Seller Account: who has client access, what you can do with each person right now, and whether you can invite someone. The answers come from Apostra, not from the screen or the agent. Show or act on only what the read offers. Use it before inviting or managing a client.
The call works in a Seller Account only, and only for an advertiser your organization owns. It refuses an advertiser that belongs to another organization, including one shared with you through an advertiser grant.

​
What comes back

Each entry in people has: availableActions is the whole list. An action that is not in it will be refused, for example approve before the person has accepted the invitation, or any action on a System advertiser. invite.available is true when you can invite someone. Then invite.eligibilityRevision is the value to send with the invitation. When it is false, invite.reason says why in plain words.

​
Who sees what

Anyone who can read the advertiser can see each client’s admissionState, claimState, roleSlug, and effectiveCapabilities. Only an organization administrator signed in directly, with client access turned on for the account, sees the invitation email and delivery state and gets any actions. For everyone else, including an API key, an agent acting for someone, or an impersonated session:
  • recipientEmail and deliveryState are null.
  • availableActions is empty.
  • invite.available is false and invite.reason says why.
  • canRevoke is false on every entry in lifecycles.