Returns information about accounts for a given user
- 04 Jul 2024
- DarkLight
Returns information about accounts for a given user
- Updated on 04 Jul 2024
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Get
/accounts
GET accounts
With the API authenticating on a user level, you don’t have to integrate the API authentication for each individual account you have. You can use “GET accounts” to pull an up-to-date list of accounts and automatically do your needed requests for every account you have. Please note: if you add or remove your user account to or from a publisher or advertiser account, it may take up to 10 minutes until this change in access rights takes effect in the API.
Who can use it
Every user has at least one publisher or advertiser account. Please note: to use one of the other endpoints/methods to retrieve account data, you need to at least have "viewer" access to the account.
Header parameters
Authorization
string
accessToken
Query parameters
accessToken
stringRequired
access token
type
string
type of account: advertiser or publisher
Responses
200
OK
object
Which data fields do we provide
| field name | description |
| accountId | ID of the account, as known from the frontend URLs (e.g. https://ui.awin.com/awin/affiliate/45628) |
| accountName | programme name for an advertiser and company name for a publisher |
| accountType | can be either publisher or advertiser |
| userRole | the role your user account has for the account |
Was this article helpful?