---
title: "Get advertiser ads.txt lines"
type: reference
method: GET
path: /rest-api/advertisers/{advertiserId}/ads-txt.do
tag: "Advertisers"
---

# Get advertiser ads.txt lines

`GET https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/{advertiserId}/ads-txt.do`

Returns the ads.txt lines stored on the advertiser, parsed: each line's id, kind (RECORD — domain, account ID, DIRECT or RESELLER, optional certification ID; VARIABLE — e.g. INVENTORYPARTNERDOMAIN=), its text, and notPublished — why a variable stored before such lines were refused (OWNERDOMAIN, MANAGERDOMAIN, CONTACT, SUBDOMAIN) is left out of every site's block, else null. They belong on an advertiser that is really a demand partner selling through its own tag (an ad network or exchange tag, a DSP seat): ads.txt lists sellers, so an ordinary advertiser that only buys has none. Every site with one of the advertiser's active banners linked to an active placement adds them to its ads.txt block. Requires ENABLED or READONLY level on the ADVERTISER_ADS_TXT permission and VIEW permission on the advertiser.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `advertiserId` | integer | yes | `1001` | Unique numeric ID of the advertiser |

## Responses

- `200` — Lines returned
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — No ADVERTISER_ADS_TXT permission, or the advertiser is outside the caller's shares
- `404` — Advertiser not found

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/advertisers/get-advertisers-ads-txt