---
title: "Get Program Information"
slug: "get-program-information-for-publisher-by-relationship-and-optionally-filter-by-country"
updated: 2026-01-08T15:26:06Z
published: 2026-01-08T15:26:06Z
canonical: "help.awin.com/get-program-information-for-publisher-by-relationship-and-optionally-filter-by-country"
---

> ## 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.

# Get Program Information

Get/publishers/{publisherId}/programmes

		
			

> [!NOTE]
> This API is Available on Zapier
> 
> Automate your workflows with Zapier's easy to use workflow builder. Read more [here](https://developer.awin.com/apidocs/integrate-apis-with-zapier)or go directly our [Zapier Integration Page](https://zapier.com/apps/awin/integrations).

**GET programmes**

Publishers can check programmatically, with which programmes they currently have an active, pending, suspended, rejected or not joined relationship. They can also check the whole program list, and filter by program region/country.

**Who can use it?**

Publishers

		
		

Header parametersAuthorizationstring

accessToken

Path parameterspublisherIdstringRequired

publisher id

Query parametersaccessTokenstringRequired

access token

countryCodestring

country code has to be ISO Alpha-2, i.e. GB, DE, FR, ...

includeHiddenboolean

Only works when no relationship is specified

relationshipstring

relationship

Valid values[
  "joined",
  "pending",
  "suspended",
  "rejected",
  "notjoined"
]

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='8c50ae67-c883-46aa-8851-c57f53f50fcf'>*/*</option>
</select>Array of object   object  clickThroughUrlstring    
currencyCodestring    
descriptionstring    
displayUrlstring    
idinteger  (int64)    
linkStatusstring    
logoUrlstring    
namestring    
primaryRegionobject (PrimaryRegion)  countryCodestring    
namestring    

primarySectorstring    
statusstring    
validDomains Array of object (Domain)   object  domainstring    

		
			

Which data fields do we provide?

| field name | description |
| --- | --- |
| description | advertiser programme description |
| displayUrl | programme display URL |
| logoUrl | URL to the logo of the programme |
| clickThroughUrl | programme click-through URL |
| id | advertiser programme ID |
| name | programme name |
| currencyCode | ISO code of the currency of the programme |
| primaryRegion | programme primary region |
| status | programme status. Can be active or hidden |
| validDomains | list of the programme valid domains |
| linkStatus | current status of links, which can be either "online" or "offline" - this applies only to programs that are funded through prepayment funds |