Skip to main content

List employer campaigns and statuses

GET 
/v1/campaigns

Lists an employer's campaigns and their statuses. Results might be paginated.

Example: List active campaigns, up to 100 per page:

https://apis.indeed.com/ads/v1/campaigns?status=ACTIVE&perPage=100
OAuth scopeAccess token type
employer.advertising.campaign.read

Employer access token.

Request​

Query Parameters

    perPage integer

    Default value: 30

    Maximum number of campaigns in the response. The response can include fewer campaigns than requested, even if more results are available. Always check whether another page exists. Maximum 500 campaigns per page.

    start string

    Position within a paginated response. If more results are available, the response includes the position for the next page.

    status string

    Possible values: [ACTIVE, DELETED, PAUSED]

    Campaign status. Pass ACTIVE, DELETED, or PAUSED to filter results by status. By default, the response includes campaigns in all statuses.

    type string

    Possible values: [SOURCE, HOSTED]

    Job type. Pass SOURCE to filter for jobs gathered from the web or sent to Indeed through an XML feed, or HOSTED for jobs posted through the Post a Job page. By default, the response includes both job types.

    fields string

    Comma-separated list of fields to include in the response. Valid values are Id, Name, Status, NonSpendingReasons, Type, CurrencyCode, TrackingToken, StartDate, FixedEndDate, TargetEndDate, BudgetOnetimeLimit, BudgetMonthlyLimit, FundingSource, SponsorshipPlan, and DailyAvgBudgetPerJob. Default is Id, Name, Status.

    campaignIds string

    Comma-separated list of campaignIds to return.

    Supports up to 50 campaign IDs.

    Only fields is supported.

Responses​

Lists campaigns.

If no campaigns match and campaignIds is omitted, the API returns an empty data.Campaigns array with HTTP status 200.

Results may be paginated.

If more results are available, meta.links includes an item with "rel": "next".

Append its href value to the base URL to get the next page.

The next URL includes only the start parameter.

If you used non-default values for perPage, status, or type, add them manually.

Schema

    meta

    object

    Response-related metadata.

    status int32

    HTTP status code of the response.

    errors

    object[]

    Any errors that prevented successful processing of the request. If there were no errors, the value is null.

  • Array [

    • type string

    Name of the error.

    description string

    Human-readable description of the problem.

  • ]

    • rootLocation string

    Base URL of the Sponsored Jobs API.

    perPage int32

    For endpoints that return paginated results, the effective maximum number of entries returned on one page. The value may be smaller than the maximum you requested with the perPage parameter. If the endpoint returns a single result or doesn't paginate, the value is null.

    links

    object[]

    Resources related to the requested resource.

  • Array [

    • rel string

    The relationship between the requested resource and the related resource. These values are commonly used:

    • up: The related resource is a collection that contains the requested resource, or an entity that the requested resource is attached to.
    • next: The next page of entries in a paginated result.
    • prev: The previous page of entries in a paginated result.

    However, the value may also be an arbitrary string describing the relationship, such as Campaign Info.

    href string

    Endpoint URL of the related resource. Can contain query string parameters. To get the complete URL, append the href to rootLocation.

  • ]

    • data

    object

    Campaigns

    object[]

  • Array [

    • Name string

    Possible values: non-empty and <= 250 characters

    Campaign name. Use it to identify the campaign later. It must be unique within your employer account.

    Id string

    Campaign ID. Automatically generated when the campaign is created.

    Status string

    Possible values: [ACTIVE, DELETED, PAUSED]

    Default value: ACTIVE

    Campaign status. PAUSED keeps the campaign inactive until you enable it, or temporarily stops sponsorship.

    NonSpendingReasons

    object[]

    List of reasons that are currently preventing the campaign from sponsoring jobs.

  • Array [

    • type string

    Possible values: [BEFORE_START_DATE, AFTER_END_DATE, ACCOUNT_MONTHLY_BUDGET_HIT, MONTHLY_BUDGET_HIT, ONETIME_BUDGET_HIT, JOB_SOURCE_NOT_VERIFIED, BILLING_PENDING, USER_PAUSED_CAMPAIGN, USER_DELETED_CAMPAIGN, TARGET_APPLICATIONS_HIT, OTHER]

    Identifier for the problem. Value is:

    • BEFORE_START_DATE: The current date in US Central Time is before the campaign start date.
    • AFTER_END_DATE: The current date in US Central Time is on or after the campaign end date.
    • ACCOUNT_MONTHLY_BUDGET_HIT: The employer account has already spent its budget this month.
    • MONTHLY_BUDGET_HIT: The campaign has already spent its budget this month.
    • ONETIME_BUDGET_HIT: The campaign has already spent its budget.
    • JOB_SOURCE_NOT_VERIFIED: The job source hasn't been verified by Indeed yet.
    • BILLING_PENDING: The employer account doesn't have valid billing information.
    • USER_PAUSED_CAMPAIGN: Campaign has been paused, as requested.
    • USER_DELETED_CAMPAIGN: The campaign has been deleted as requested.
    • TARGET_APPLICATIONS_HIT: The campaign has already received the requested number of applications.
    • OTHER: Unknown reason.
    description string

    Human-readable description of the problem.

  • ]

    • Type string

    Possible values: [SOURCE, HOSTED]

    Type of job sponsored by the campaign. Either SOURCE (jobs gathered from the web, or sent to Indeed using an XML feed) or HOSTED (jobs posted using the Post a Job page).

    CurrencyCode string

    ISO 4217 currency code of the currency for the campaign's budget.

    TrackingToken string

    Possible values: <= 255 characters

    Click-tracking token appended to the job URL on sponsored clicks. Allows you to identify that the click is from Indeed, and identify the campaign that sponsored the click.

    BudgetOnetimeLimit number

    One-time budget limit for the campaign. You cannot set budgetOnetimeLimit and budgetMonthlyLimit at the same time.

    BudgetMonthlyLimit number

    Monthly budget limit for the campaign. You cannot set dailyAvgBudgetPerJob, budgetOnetimeLimit, and budgetMonthlyLimit at the same time.

    StartDate date

    Date when the campaign starts sponsoring jobs, in ISO 8601 YYYY-MM-DD format. Default is current date.

    The campaign starts sponsoring jobs at the start of the specified day in US Central Time (CT, US/Central). The start date is on or after the current date in CT. For example, if the startDate is 2026-01-15, the campaign starts sponsoring on January 15, 2026 at 0:00 AM CT. If the start date is not provided or is the current date, the campaign starts sponsoring immediately.

    Once the campaign is active and spending, you cannot update its startDate. If you wish to temporarily pause a campaign, set its status to PAUSED.

    FixedEndDate date

    Date before when the campaign must stop sponsoring jobs, even if it has remaining unspent budget. Follows the ISO 8601 YYYY-MM-DD format.

    A campaign with a one-time budget (budgetOnetimeLimit) always have either a fixedEndDate or a targetEndDate, but not both.

    A campaign with a monthly recurring budget (budgetMonthlyLimit) may optionally have a fixedEndDate. Monthly recurring campaigns default to sponsoring jobs until you manually pause or delete the campaign. These are called "evergreen" campaigns. To stop the campaign at the start of a specified day, specify fixedEndDate.

    The campaign stops sponsoring jobs at the start of the specified day in US Central Time (CT, US/Central). The fixedEndDate is atleast one day after the current date in CT, or the startDate of the campaign, if the campaign has one. For example, if the fixed end date is 2026-06-20, the campaign stops on June 20, 2021 at 0:00 AM CT.

    TargetEndDate date

    Date before when the campaign should stop sponsoring jobs, though it can continue sponsoring past the specified date if it has not spent its budget yet. Follows the ISO 8601 YYYY-MM-DD format.

    A campaign with a one-time budget (budgetOnetimeLimit) always have either a fixedEndDate or a targetEndDate, but not both. A campaign with a monthly recurring budget (budgetMonthlyLimit) cannot have a targetEndDate, only a fixedEndDate or no end date.

    The campaign targets the start of the specified day in US Central Time (CT, US/Central). The target end date is at least one day after the current date in CT, or the startDate of the campaign, if the campaign has one. For example, if the target end date is 2026-06-20, the campaign targets June 20, 2021 at 0:00 AM CT.

    FundingSource string

    Funding source for the campaign:

    • Bonus Sponsored Job Credits: Funded with Annual Deals bonus credits.
    • Budget: Funded with regular budget.

    Possible values: [Bonus Sponsored Job Credits, Budget].

    SponsorshipPlan string

    Possible values: [PREMIUM, STANDARD, ``]

    Sponsorship tier for average daily budget (ADB) campaigns. Returned only if requested with the fields parameter.

    For campaigns funded by annual deals bonus credits, this field returns STANDARD for standard campaigns, PREMIUM for premium campaigns, or an empty string otherwise.

    DailyAvgBudgetPerJob number

    Effective average daily budget (ADB) per job for the campaign. Returned only for campaigns that use the ADB model. You cannot set dailyAvgBudgetPerJob and budgetMonthlyLimit at the same time.

  • ]

Loading...

Was this page helpful?