> ## Documentation Index > Fetch the complete documentation index at: https://help.awin.com/llms.txt > Use this file to discover all available pages before exploring further. # List partnerships (publishers) > Use this to see which advertisers a publisher has a partnership with, optionally filtered by partnership status. Closed advertiser accounts are not listed. Results are ordered by `-partnership.statusUpdatedAt` unless `sort` is given, and are paginated with `limit` and `offset`. Side effects: none. This operation is read-only and safe to repeat. The caller needs the Viewer role or higher on the publisher account. Errors: - `400`: a query parameter is invalid, for example an unknown `partnershipStatus` or `sort` value, a `limit` above 1000 or an `offset` above 10000; or the path parameter is malformed. - `404`: the publisher does not exist. ## OpenAPI ````json GET /v1/publishers/{publisherId}/advertisers { "openapi": "3.0.3", "info": { "title": "Awin Public API", "version": "0.1.0" }, "servers": [ { "url": "https://api.awin.com/public", "description": "Production" } ], "tags": [ { "name": "Advertisers", "description": "Endpoints for advertiser accounts." }, { "name": "Advertisers > Partnerships", "description": "Advertiser partnerships with publishers." }, { "name": "Advertisers > Tracking links", "description": "Advertiser tracking links." }, { "name": "Advertisers > Billing", "description": "Advertiser billing and prepayments." }, { "name": "Publishers", "description": "Endpoints for publisher accounts." }, { "name": "Publishers > Partnerships", "description": "Publisher partnerships with advertisers." }, { "name": "Publishers > Transactions", "description": "Publisher transactions." }, { "name": "Publishers > Payments", "description": "Publisher payments and payment details." } ], "paths": { "/v1/publishers/{publisherId}/advertisers": { "x-awin-owner": "hqteamorion", "parameters": [ { "$ref": "#/components/parameters/PublisherId" } ], "get": { "tags": [ "Publishers > Partnerships" ], "operationId": "listPublisherAdvertisers", "x-awin-audience": "public", "summary": "List partnerships (publishers)", "description": "Use this to see which advertisers a publisher has a partnership with,\noptionally filtered by partnership status.\n\nClosed advertiser accounts are not listed. Results are ordered by\n`-partnership.statusUpdatedAt` unless `sort` is given, and are paginated\nwith `limit` and `offset`.\n\nSide effects: none. This operation is read-only and safe to repeat.\n\nThe caller needs the Viewer role or higher on the publisher account.\n\nErrors:\n- `400`: a query parameter is invalid, for example an unknown `partnershipStatus` or\n `sort` value, a `limit` above 1000 or an `offset` above 10000; or the\n path parameter is malformed.\n- `404`: the publisher does not exist.", "x-awin-public-api-authorization": { "accountType": "publisher", "minRole": "userViewer" }, "parameters": [ { "$ref": "#/components/parameters/PartnershipStatusFilter" }, { "$ref": "#/components/parameters/PartnershipSort" }, { "$ref": "#/components/parameters/PartnershipLimit" }, { "$ref": "#/components/parameters/Offset" } ], "responses": { "200": { "description": "A page of the publisher's advertisers.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/PaginatedResult" }, { "type": "object", "required": [ "results" ], "properties": { "results": { "type": "array", "description": "The advertisers in this page.", "items": { "$ref": "#/components/schemas/PublisherAdvertiser" } } } } ] }, "example": { "total": 42, "offset": 0, "limit": 3, "results": [ { "id": "1001", "type": "ADVERTISER", "name": "Example Advertiser", "logoUrl": "https://ui.awin.com/images/upload/merchant/profile/1001.png", "partnership": { "status": "ACTIVE", "statusUpdatedAt": "2025-10-01T14:30:00Z" } }, { "id": "1002", "type": "ADVERTISER", "name": "Another Advertiser", "partnership": { "status": "APPLICATION_PENDING", "statusUpdatedAt": "2025-09-15T09:12:00Z" } }, { "id": "1003", "type": "ADVERTISER", "name": "Legacy Advertiser", "logoUrl": "https://ui.awin.com/images/upload/merchant/profile/1003.png", "partnership": { "status": "ADVERTISER_SUSPENDED" } } ] } } }, "headers": { "RateLimit-Limit": { "$ref": "#/components/headers/RateLimitLimit" }, "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimitRemaining" }, "RateLimit-Reset": { "$ref": "#/components/headers/RateLimitReset" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "default": { "$ref": "#/components/responses/UnexpectedError" } }, "security": [ { "patBearer": [] } ] } } }, "components": { "parameters": { "PublisherId": { "name": "publisherId", "in": "path", "required": true, "description": "Identifier of the publisher account.", "schema": { "type": "string", "pattern": "^[0-9]+$", "example": "45678" } }, "PartnershipStatusFilter": { "name": "partnershipStatus", "in": "query", "required": false, "description": "Comma-separated list of partnership statuses to filter by. When omitted, partnerships in any status are returned.", "style": "form", "explode": false, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PartnershipStatus" } }, "example": [ "INVITE_PENDING", "APPLICATION_PENDING" ] }, "PartnershipSort": { "name": "sort", "in": "query", "required": false, "description": "Field to sort by, ascending by default and descending when prefixed with `-`. `partnership.statusUpdatedAt` sorts by the timestamp the partnership reached its current status, with partnerships whose timestamp is unknown last. `name` sorts by the name of the other account in the partnership. Results with the same value are ordered by that account's ID. Any other value is rejected with `400`.", "schema": { "type": "string", "enum": [ "partnership.statusUpdatedAt", "-partnership.statusUpdatedAt", "name", "-name" ], "default": "-partnership.statusUpdatedAt" }, "example": "-partnership.statusUpdatedAt" }, "PartnershipLimit": { "name": "limit", "in": "query", "required": false, "description": "Maximum number of results to return.", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 10, "example": 10 } }, "Offset": { "name": "offset", "in": "query", "required": false, "description": "Number of results to skip. Offsets beyond 10000 are rejected with `400`.", "schema": { "type": "integer", "minimum": 0, "maximum": 10000, "default": 0, "example": 0 } } }, "schemas": { "PaginatedResult": { "type": "object", "description": "Envelope for an offset-paginated collection.", "required": [ "total", "offset", "limit", "results" ], "properties": { "total": { "type": "integer", "minimum": 0, "description": "Total number of results across all pages.", "example": 567 }, "offset": { "type": "integer", "minimum": 0, "description": "Number of results skipped before this page.", "example": 200 }, "limit": { "type": "integer", "minimum": 1, "description": "Maximum number of results in this page.", "example": 50 }, "results": { "type": "array", "description": "The results in this page.", "items": {} } } }, "PublisherAdvertiser": { "type": "object", "description": "An advertiser in a publisher's list of partnerships, with the status of their partnership.", "required": [ "id", "type", "name", "partnership" ], "properties": { "id": { "allOf": [ { "$ref": "#/components/schemas/AdvertiserId" } ], "description": "Identifier of the advertiser account.", "example": "1001" }, "type": { "type": "string", "description": "Type of the account.", "enum": [ "ADVERTISER" ], "example": "ADVERTISER" }, "name": { "type": "string", "description": "Display name of the advertiser. Never null.", "minLength": 1, "example": "Example Advertiser" }, "logoUrl": { "type": "string", "format": "uri", "description": "URL of the advertiser's logo. Omitted when the advertiser has not uploaded a logo.", "example": "https://ui.awin.com/images/upload/merchant/profile/1001.png" }, "partnership": { "type": "object", "description": "The partnership between the publisher and the advertiser.", "required": [ "status" ], "properties": { "status": { "$ref": "#/components/schemas/PartnershipStatus" }, "statusUpdatedAt": { "type": "string", "format": "date-time", "description": "UTC timestamp when the partnership reached its current status. Omitted when that timestamp is not recorded.", "example": "2025-10-01T14:30:00Z" } } } } }, "PartnershipStatus": { "type": "string", "description": "Status of the partnership between a publisher and an advertiser.\n\n- `ACTIVE`: the publisher has joined the advertiser, including partnerships pending suspension.\n- `INVITE_PENDING`: the advertiser has invited the publisher and the invitation has not been actioned yet.\n- `INVITE_REJECTED`: the publisher has declined the advertiser's invitation.\n- `APPLICATION_PENDING`: the publisher has applied to the advertiser and the application has not been actioned yet.\n- `APPLICATION_REJECTED`: the advertiser has rejected the publisher's application.\n- `ADVERTISER_SUSPENDED`: the advertiser has suspended the partnership.\n- `PUBLISHER_LEFT`: the publisher has left the partnership.\n\nNew values may be added; treat an unknown value as a non-fatal case.", "enum": [ "ACTIVE", "INVITE_PENDING", "INVITE_REJECTED", "APPLICATION_PENDING", "APPLICATION_REJECTED", "ADVERTISER_SUSPENDED", "PUBLISHER_LEFT" ], "example": "ACTIVE" }, "AdvertiserId": { "type": "string", "pattern": "^[0-9]+$", "description": "Identifier of the advertiser account.", "example": "1001" }, "ValidationProblem": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "description": "A problem detail carrying the RFC 9457 extension member `errors`, used where a request fails validation on one or more specific fields.", "properties": { "errors": { "type": "array", "description": "One entry per field that failed validation.", "items": { "type": "object", "required": [ "pointer", "detail" ], "properties": { "pointer": { "type": "string", "description": "An [RFC 6901](https://www.rfc-editor.org/rfc/rfc6901) JSON Pointer to the offending field in the request.", "example": "/name" }, "detail": { "type": "string", "description": "A human-readable explanation of this field's failure.", "example": "must be 100 characters or fewer" } } } } } } ] }, "Problem": { "type": "object", "description": "Problem details for an HTTP API error, as defined by [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457). Served as `application/problem+json`.", "required": [ "title", "status", "detail", "code" ], "properties": { "type": { "type": "string", "format": "uri-reference", "default": "https://help.awin.com/apis/error", "description": "A URI reference identifying the problem type. APIs SHOULD define a stable, dereferenceable URI per domain-specific problem type.", "example": "https://help.awin.com/apis/error" }, "title": { "type": "string", "description": "A short, human-readable summary of the problem type. Stable across occurrences; does not change from occurrence to occurrence.", "example": "Not Found" }, "status": { "type": "integer", "description": "The HTTP status code, repeated here for convenience.", "example": 404 }, "detail": { "type": "string", "description": "A human-readable explanation specific to this occurrence. Intended for the developer, not the end user — do not parse it.", "example": "Resource not found with that ID" }, "instance": { "type": "string", "format": "uri-reference", "description": "A URI reference identifying this specific occurrence, typically the request path.", "example": "/v1/advertisers/12345/prepayments" }, "code": { "type": "string", "description": "A stable, machine-readable error code. It does not change when `detail` is reworded, so clients branch on `code`, never on `detail`.", "enum": [ "VALIDATION_FAILED", "INVALID_SORT", "UNAUTHORIZED", "MISSING_TOKEN", "INVALID_TOKEN", "FORBIDDEN", "ACCESS_DENIED", "CLIENT_NOT_CONFIGURED", "NOT_FOUND", "METHOD_NOT_ALLOWED", "NOT_ACCEPTABLE", "CONFLICT", "CONTENT_TOO_LARGE", "UNSUPPORTED_MEDIA_TYPE", "BUSINESS_RULE_VIOLATION", "TOO_MANY_REQUESTS", "USER_RATE_LIMIT_EXCEEDED", "ROUTE_RATE_LIMIT_EXCEEDED", "LINK_SHORTENER_QUOTA_EXCEEDED", "INTERNAL_ERROR", "BAD_GATEWAY", "SERVICE_UNAVAILABLE", "DEPENDENCY_UNAVAILABLE", "GATEWAY_TIMEOUT", "FEATURE_NOT_ENABLED", "ACCOUNT_IN_DEBT", "DUPLICATE_ENQUIRY_ID", "TRANSACTION_QUERY_NOT_PENDING", "MEMBERSHIP_INACTIVE", "ORDER_REF_ALREADY_TRACKED", "ORDER_REF_ALREADY_QUERIED", "TRANSACTION_DATE_BEFORE_ADVERTISER_LIVE_DATE", "CURRENCY_NOT_SUPPORTED", "CURRENCY_MISMATCH", "TRANSACTION_DATE_IN_FUTURE", "TRANSACTION_DATE_TOO_OLD", "OVERRIDE_NOT_ALLOWED" ], "example": "NOT_FOUND" } } } }, "headers": { "RateLimitLimit": { "description": "Maximum number of requests you can make in a burst under your own rate limit. Absent when the request did not count against your own limit.", "schema": { "type": "integer", "minimum": 1, "example": 5 } }, "RateLimitRemaining": { "description": "Number of requests you have left under your own rate limit. Absent when the request did not count against your own limit.", "schema": { "type": "integer", "minimum": 0, "example": 0 } }, "RateLimitReset": { "description": "Number of seconds until your own rate limit is fully restored. Absent when the request did not count against your own limit.", "schema": { "type": "integer", "minimum": 0, "example": 1 } }, "RetryAfter": { "description": "Number of seconds to wait before retrying the request.", "required": true, "schema": { "type": "integer", "minimum": 0, "example": 1 } } }, "responses": { "BadRequest": { "description": "Bad Request", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblem" }, "example": { "type": "https://help.awin.com/apis/error", "title": "Bad Request", "status": 400, "detail": "Required parameters are missing from the request", "code": "VALIDATION_FAILED", "errors": [ { "pointer": "/name", "detail": "must be 100 characters or fewer" } ] } } }, "headers": { "RateLimit-Limit": { "$ref": "#/components/headers/RateLimitLimit" }, "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimitRemaining" }, "RateLimit-Reset": { "$ref": "#/components/headers/RateLimitReset" } } }, "Unauthorized": { "description": "Unauthorized", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://help.awin.com/apis/error", "title": "Unauthorized", "status": 401, "detail": "No valid credentials were supplied with the request", "code": "UNAUTHORIZED" } } } }, "Forbidden": { "description": "Forbidden", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://help.awin.com/apis/error", "title": "Forbidden", "status": 403, "detail": "You do not have the correct privileges to access this resource", "code": "FORBIDDEN" } } }, "headers": { "RateLimit-Limit": { "$ref": "#/components/headers/RateLimitLimit" }, "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimitRemaining" }, "RateLimit-Reset": { "$ref": "#/components/headers/RateLimitReset" } } }, "NotFound": { "description": "Not Found", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://help.awin.com/apis/error", "title": "Not Found", "status": 404, "detail": "Resource not found with that ID", "code": "NOT_FOUND" } } }, "headers": { "RateLimit-Limit": { "$ref": "#/components/headers/RateLimitLimit" }, "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimitRemaining" }, "RateLimit-Reset": { "$ref": "#/components/headers/RateLimitReset" } } }, "TooManyRequests": { "description": "Too Many Requests", "headers": { "Retry-After": { "$ref": "#/components/headers/RetryAfter" }, "RateLimit-Limit": { "$ref": "#/components/headers/RateLimitLimit" }, "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimitRemaining" }, "RateLimit-Reset": { "$ref": "#/components/headers/RateLimitReset" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "userRateLimitExceeded": { "value": { "type": "https://help.awin.com/apis/error", "title": "User rate limit exceeded", "status": 429, "detail": "You have exceeded your rate limit across the public API. Retry after the number of seconds in the Retry-After header", "code": "USER_RATE_LIMIT_EXCEEDED" } }, "routeRateLimitExceeded": { "value": { "type": "https://help.awin.com/apis/error", "title": "Route rate limit exceeded", "status": 429, "detail": "This endpoint is receiving more requests than it can accept right now. Retry after the number of seconds in the Retry-After header", "code": "ROUTE_RATE_LIMIT_EXCEEDED" } }, "tooManyRequests": { "value": { "type": "https://help.awin.com/apis/error", "title": "Too Many Requests", "status": 429, "detail": "Rate limit exceeded", "code": "TOO_MANY_REQUESTS" } } } } } }, "ServiceUnavailable": { "description": "Service Unavailable", "headers": { "Retry-After": { "$ref": "#/components/headers/RetryAfter" }, "RateLimit-Limit": { "$ref": "#/components/headers/RateLimitLimit" }, "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimitRemaining" }, "RateLimit-Reset": { "$ref": "#/components/headers/RateLimitReset" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://help.awin.com/apis/error", "title": "Service Unavailable", "status": 503, "detail": "The service is temporarily unavailable", "code": "SERVICE_UNAVAILABLE" } } } }, "UnexpectedError": { "description": "Internal Server Error", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://help.awin.com/apis/error", "title": "Internal Server Error", "status": 500, "detail": "An unexpected error occurred", "code": "INTERNAL_ERROR" } } }, "headers": { "RateLimit-Limit": { "$ref": "#/components/headers/RateLimitLimit" }, "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimitRemaining" }, "RateLimit-Reset": { "$ref": "#/components/headers/RateLimitReset" } } } }, "securitySchemes": { "patBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Personal Access Token, sent as `Authorization: Bearer `." } } } } ````