---
updatedAt: 2026-10-20T00:32:49.000Z
agentTools:
  projectIndex: https://dev.kevel.com/llms.txt
---

# Get Advertiser

## Why Get an Advertiser?

When you are working with an advertiser, you will find it useful to return all of the properties associated with that advertiser. This API endpoint enables you to receive a full set of properties and attributes for an advertiser.

## API Syntax

When using the Get Advertiser API endpoint, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:

`GET https://api.kevel.co/v1/advertiser/{AdvertiserID}`

Where:

* `GET` - the type of API request being made.
* `https://api.kevel.co` - the URL for the request.
* `v1` - the API version.
* `advertiser` - the API endpoint being called.
* `AdvertiserID` - the ID associated with the advertiser you want to return.

> 📘 Wallets
>
> When Kevel has turned it on for your network, the response includes a `Wallets` array with the Advertiser's wallet assignments. See [List Advertiser Wallets](https://dev.kevel.com/reference/list-advertiser-wallets).

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "management-api-2",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.kevel.co"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "X-Adzerk-ApiKey",
        "in": "header"
      }
    },
    "schemas": {
      "WalletSummary": {
        "type": "object",
        "description": "A summary of the wallet. It does not include the Balance.",
        "required": [
          "Id",
          "Name",
          "Currency",
          "Limit",
          "IsActive"
        ],
        "properties": {
          "Id": {
            "type": "integer",
            "example": 2041
          },
          "Name": {
            "type": "string",
            "maxLength": 200,
            "example": "Acme Q4 2026, PO 7781"
          },
          "Currency": {
            "type": "string",
            "example": "USD"
          },
          "Limit": {
            "type": "integer",
            "example": 50000
          },
          "NotificationThreshold": {
            "type": [
              "integer",
              "null"
            ],
            "example": 5000
          },
          "ExternalId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 200,
            "example": "PO-7781"
          },
          "IsActive": {
            "type": "boolean",
            "example": true
          }
        }
      },
      "AdvertiserWallet": {
        "type": "object",
        "required": [
          "Id",
          "AdvertiserId",
          "WalletId",
          "Wallet"
        ],
        "properties": {
          "Id": {
            "type": "integer",
            "description": "The assignment's ID, not the wallet's. Pass it to remove the assignment.",
            "example": 311
          },
          "AdvertiserId": {
            "type": "integer",
            "example": 5530
          },
          "WalletId": {
            "type": "integer",
            "example": 2041
          },
          "Wallet": {
            "$ref": "#/components/schemas/WalletSummary"
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/advertiser/{AdvertiserID}": {
      "get": {
        "summary": "Get Advertiser",
        "description": "",
        "operationId": "get-advertisers",
        "parameters": [
          {
            "name": "AdvertiserID",
            "in": "path",
            "description": "The ID of the Advertiser",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"IsActive\": true,\n    \"Created\": \"2024-10-08T20:15:58.820Z\",\n    \"CatalogAccess\": [\n        {\n            \"ProductQuery\": [\n                [\n                    [\n                        \"one-of\",\n                        \"kevel/brand-id\"\n                    ],\n                    [\n                        2762035,\n                        2764718,\n                        2765001\n                    ]\n                ]\n            ],\n            \"CatalogId\": 310\n        }\n    ],\n    \"DailyCapAmount\": 100,\n    \"FreqCapType\": 1,\n    \"Title\": \"Big Cashew Co.\",\n    \"ExternalId\": \"3faa9840-fd2d-40d1-82b0-cf654067ceea\",\n    \"CapType\": 4,\n    \"IsFreqCap\": true,\n    \"IsDeleted\": false,\n    \"LifetimeCapAmount\": 555555,\n    \"LastModified\": \"2025-05-30T20:24:55.120Z\",\n    \"FreqCapDuration\": 1,\n    \"PlacementLimit\": 1,\n    \"FreqCap\": 5,\n    \"PartnerId\": null,\n    \"Version\": 4,\n    \"Id\": 3423675,\n    \"CustomFieldsJson\": null\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "IsActive": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "Created": {
                      "type": "string",
                      "example": "2024-10-08T20:15:58.820Z"
                    },
                    "CatalogAccess": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "ProductQuery": {
                            "type": "array",
                            "items": {
                              "type": "array",
                              "items": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "example": "one-of"
                                }
                              }
                            }
                          },
                          "CatalogId": {
                            "type": "integer",
                            "example": 310,
                            "default": 0
                          }
                        }
                      }
                    },
                    "DailyCapAmount": {
                      "type": "integer",
                      "example": 100,
                      "default": 0
                    },
                    "FreqCapType": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "Title": {
                      "type": "string",
                      "example": "Big Cashew Co."
                    },
                    "ExternalId": {
                      "type": "string",
                      "example": "3faa9840-fd2d-40d1-82b0-cf654067ceea"
                    },
                    "CapType": {
                      "type": "integer",
                      "example": 4,
                      "default": 0
                    },
                    "IsFreqCap": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "IsDeleted": {
                      "type": "boolean",
                      "example": false,
                      "default": true
                    },
                    "LifetimeCapAmount": {
                      "type": "integer",
                      "example": 555555,
                      "default": 0
                    },
                    "LastModified": {
                      "type": "string",
                      "example": "2025-05-30T20:24:55.120Z"
                    },
                    "FreqCapDuration": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "PlacementLimit": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "FreqCap": {
                      "type": "integer",
                      "example": 5,
                      "default": 0
                    },
                    "PartnerId": {},
                    "Version": {
                      "type": "integer",
                      "example": 4,
                      "default": 0
                    },
                    "Id": {
                      "type": "integer",
                      "example": 3423675,
                      "default": 0
                    },
                    "CustomFieldsJson": {},
                    "Wallets": {
                      "type": "array",
                      "description": "The wallets assigned to the Advertiser. Returned only when Kevel has turned it on for your network.",
                      "items": {
                        "$ref": "#/components/schemas/AdvertiserWallet"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl -X GET -H \"X-Adzerk-ApiKey:$ADZERK_API_KEY\" https://api.kevel.co/v1/advertiser/123"
            },
            {
              "language": "javascript",
              "code": "const Adzerk = require('@adzerk/management-sdk');\nconst apiKey = process.env.ADZERK_API_KEY;\n\nasync function getAdvertiser() {\n  let specifications = await Adzerk.fetchSpecifications();\n  let client = await Adzerk.buildClient({apiKey, specifications});\n\n  let advertiser = await client.run(\"advertiser\", \"get\", {id: 12345});\n  console.log(advertiser);\n}\n\ngetAdvertiser();"
            },
            {
              "language": "ruby",
              "code": "require \"adzerk\"\n\ndef get_advertiser()\n    client = Adzerk::Client.new(ENV[\"ADZERK_API_KEY\"])\n    advertiser_id = 12345\n    pp client.advertisers.get(advertiser_id)\nend\nget_advertiser()"
            }
          ],
          "samples-languages": [
            "curl",
            "javascript",
            "ruby"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "X-Adzerk-Sdk-Version",
        "value": "Readme.io:ManagementAPI2"
      }
    ],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```