# Search jobs.

Search jobs by keyword with EnvoAPI. Filter by location, company, experience, employment type, workplace, Easy Apply, applicant count or posting time and paginate through matching jobs.

`GET https://api.envoapi.com/v1/jobs/search`

Operation ID: `searchJobs`

## Authentication

See [Authentication](https://docs.envoapi.com/guides/authentication.md). Security alternatives (each object is one alternative):

```json
[
  {
    "BearerApiKey": []
  }
]
```

BearerApiKey:

```json
{
  "type": "http",
  "scheme": "bearer",
  "bearerFormat": "envo_<66 Base64url characters>"
}
```

## Credits

Uses the current Profile base Credit cost. Check your dashboard for current costs; example charges are illustrative.

## Parameters

### keywords

Location: query. Required: yes.

Schema: {"type":"string","minLength":1,"maxLength":500}

Example:

```json
"software engineer"
```

### start

Location: query. Required: no.

Schema: {"default":0,"type":"integer","minimum":0,"maximum":10000}

Example:

```json
0
```

### location

Location: query. Required: no.

Schema: {"type":"string","pattern":"^geo\_(?:0|\[1-9A-Za-z]\[0-9A-Za-z]{0,5})$","description":"A location ID from [Location search](https://docs.envoapi.com/api/operations/searchlocationsbykeyword.md) (`data.locations[].id`)."}

Example:

```json
"geo_6yITcz"
```

### companyIds

Location: query. Required: no.

Schema: {"type":"string","minLength":1,"maxLength":1099,"description":"Filter by company. Use IDs from [Company details](https://docs.envoapi.com/api/operations/getcompanydetailsbyslug.md) (`data.publicId`), separated by commas. Jobs at any of the companies match. Find companies with [Company search](https://docs.envoapi.com/api/operations/searchcompaniesbykeyword.md)."}

Example:

```json
"company_4T4tWj"
```

### experience

Location: query. Required: no.

Schema: {"type":"string","enum":\["internship","entry","associate","mid\_senior","director","executive"]}

Example:

```json
"mid_senior"
```

### sort

Location: query. Required: no.

Schema: {"default":"relevance","type":"string","enum":\["relevance","recent"]}

Example:

```json
"relevance"
```

### timePosted

Location: query. Required: no.

Schema: {"default":"any","type":"string","enum":\["any","day","week","month"]}

Example:

```json
"any"
```

### employmentType

Location: query. Required: no.

Schema: {"type":"string","minLength":1,"maxLength":1099,"description":"Employment types: `full_time`, `part_time`, `contract`, `temporary`, `volunteer`, `internship`, or `other`. Separate types with commas."}

Example:

```json
"part_time,contract"
```

### workplaceType

Location: query. Required: no.

Schema: {"type":"string","minLength":1,"maxLength":1099,"description":"Workplace types: `on_site`, `remote`, or `hybrid`. Separate types with commas."}

Example:

```json
"remote,hybrid"
```

### easyApply

Location: query. Required: no.

Schema: {"type":"string","const":"true","description":"Set to true to show only Easy Apply jobs. Otherwise, omit this filter."}

Example:

```json
"true"
```

### under10Applicants

Location: query. Required: no.

Schema: {"type":"string","const":"true","description":"Set to true to show only jobs with fewer than 10 applicants. Otherwise, omit this filter."}

Example:

```json
"true"
```

## Request example

```bash
curl "https://api.envoapi.com/v1/jobs/search?keywords=software+engineer&start=0&location=geo_6yITcz&sort=relevance&timePosted=any" \
  --header "Authorization: Bearer $ENVO_API_KEY" \
  --header "Accept: application/json"
```

## Responses

### 200

The requested data.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [JobSearchSuccess](https://docs.envoapi.com/api/schemas/JobSearchSuccess.md)

| Field           | Required                  | Schema                                                                                                                                                                                                                         | Description                                             |
| --------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
| data            | yes                       | [JobSearchData](https://docs.envoapi.com/api/schemas/JobSearchData.md)                                                                                                                                                         | The result of the call. Fields we cannot fill are null. |
| data.jobs       | yes (when parent present) | {"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/JobSearchJob"}}                                                                                                                                           |                                                         |
| meta            | yes                       | {"type":"object","properties":{"paging":{"$ref":"#/components/schemas/JobSearchPaging"},"creditCost":{"$ref":"#/components/schemas/NonNegativeSafeInteger"}},"required":\["paging","creditCost"],"additionalProperties":false} | Information about the call itself.                      |
| meta.paging     | yes (when parent present) | [JobSearchPaging](https://docs.envoapi.com/api/schemas/JobSearchPaging.md)                                                                                                                                                     |                                                         |
| meta.creditCost | yes (when parent present) | [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md)                                                                                                                                       | How many credits this call used.                        |

Response example:

```json
{
  "data": {
    "jobs": [
      {
        "title": "Software Engineer, Intern",
        "url": "https://www.linkedin.com/jobs/view/4467767544",
        "location": "New York, NY (On-site)",
        "postedAt": "2026-09-15T20:05:53.000Z",
        "companyName": "Duolingo",
        "companyUrl": "https://www.linkedin.com/company/duolingo",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-1.jpg",
        "isPromoted": false,
        "isEasyApply": false
      },
      {
        "title": "Software Engineer, Full Stack",
        "url": "https://www.linkedin.com/jobs/view/4461788735",
        "location": "Greater Seattle Area (Hybrid)",
        "postedAt": "2026-09-01T17:32:46.000Z",
        "companyName": "Plaid",
        "companyUrl": "https://www.linkedin.com/company/plaid-",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-2.jpg",
        "isPromoted": false,
        "isEasyApply": false
      },
      {
        "title": "Software Engineer, New Grad",
        "url": "https://www.linkedin.com/jobs/view/4462041991",
        "location": "New York, United States (On-site)",
        "postedAt": "2026-09-01T20:40:12.000Z",
        "companyName": "Stripe",
        "companyUrl": "https://www.linkedin.com/company/stripe",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-3.jpg",
        "isPromoted": false,
        "isEasyApply": false
      },
      {
        "title": "Software Engineer II",
        "url": "https://www.linkedin.com/jobs/view/4461731418",
        "location": "United States (Remote)",
        "postedAt": "2026-09-01T12:43:36.000Z",
        "companyName": "Microsoft",
        "companyUrl": "https://www.linkedin.com/company/microsoft",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-4.jpg",
        "isPromoted": false,
        "isEasyApply": false
      },
      {
        "title": "Software Engineer 5 - TV Product UI",
        "url": "https://www.linkedin.com/jobs/view/4459547557",
        "location": "United States (Remote)",
        "postedAt": "2026-09-01T17:43:40.000Z",
        "companyName": "Netflix",
        "companyUrl": "https://www.linkedin.com/company/netflix",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-5.jpg",
        "isPromoted": false,
        "isEasyApply": false
      },
      {
        "title": "Remote Recruiter",
        "url": "https://www.linkedin.com/jobs/view/4458038594",
        "location": "Tennessee, United States (Remote)",
        "postedAt": "2026-08-28T02:11:52.000Z",
        "companyName": "Talentoma",
        "companyUrl": "https://www.linkedin.com/company/talentoma",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-6.jpg",
        "isPromoted": false,
        "isEasyApply": true
      },
      {
        "title": "Software Engineer Intern",
        "url": "https://www.linkedin.com/jobs/view/4466094550",
        "location": "United States (Remote)",
        "postedAt": "2026-09-11T13:32:44.000Z",
        "companyName": "MeeBoss",
        "companyUrl": "https://www.linkedin.com/company/meeboss",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-7.jpg",
        "isPromoted": false,
        "isEasyApply": false
      },
      {
        "title": "Software Engineer - Intern",
        "url": "https://www.linkedin.com/jobs/view/4459376001",
        "location": "United States (Remote)",
        "postedAt": "2026-08-26T19:41:55.000Z",
        "companyName": "Realm Alliance",
        "companyUrl": "https://www.linkedin.com/company/realmalliance",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-8.jpg",
        "isPromoted": false,
        "isEasyApply": false
      },
      {
        "title": "Internship, Software Engineer, Information Security (Winter/Spring 2027)",
        "url": "https://www.linkedin.com/jobs/view/4459659181",
        "location": "Bellevue, WA (On-site)",
        "postedAt": "2026-08-27T05:34:38.000Z",
        "companyName": "Tesla",
        "companyUrl": "https://www.linkedin.com/company/tesla-motors",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-9.jpg",
        "isPromoted": false,
        "isEasyApply": false
      },
      {
        "title": "Entry Level Software Developer-Different locations",
        "url": "https://www.linkedin.com/jobs/view/4456511924",
        "location": "Tucson, AZ (Hybrid)",
        "postedAt": "2026-09-15T14:50:14.000Z",
        "companyName": "IBM",
        "companyUrl": "https://www.linkedin.com/company/ibm",
        "companyLogoUrl": "https://image.envoapi.com/search-linked-in-jobs/image-10.jpg",
        "isPromoted": false,
        "isEasyApply": false
      }
    ]
  },
  "meta": {
    "paging": {
      "start": 0,
      "count": 10,
      "hasMore": true
    },
    "creditCost": 1
  }
}
```

### 400

A request parameter is missing or invalid.

A parameter is missing or has a value we cannot use. Read error.details, fix the value and try again.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [InvalidRequestErrorResponse](https://docs.envoapi.com/api/schemas/InvalidRequestErrorResponse.md)

### 401

Your API key is invalid or inactive.

Your API key is missing, wrong or switched off. Check it in your dashboard.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [InvalidApiKeyErrorResponse](https://docs.envoapi.com/api/schemas/InvalidApiKeyErrorResponse.md)

### 402

Your account does not have enough credits.

Your account has no credits left. Top up, then send a new call.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [InsufficientCreditsErrorResponse](https://docs.envoapi.com/api/schemas/InsufficientCreditsErrorResponse.md)

### 403

Your API key or account cannot access this endpoint.

Your account is suspended or cannot use this endpoint. Resolve the account or its access first.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [LookupForbiddenErrorResponse](https://docs.envoapi.com/api/schemas/LookupForbiddenErrorResponse.md)

### 404

The requested resource was not found.

Nothing matched what you sent. Check it for typos.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [ResourceNotFoundErrorResponse](https://docs.envoapi.com/api/schemas/ResourceNotFoundErrorResponse.md)

### 405

Use GET for this endpoint.

The route exists, but the request used a method other than GET. Use the method shown at the top of this page.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **Allow**: Required response header. Schema: {"type":"string","const":"GET"}.

Content type: `application/json`.

Schema: [MethodNotAllowedErrorResponse](https://docs.envoapi.com/api/schemas/MethodNotAllowedErrorResponse.md)

### 406

The response format in your Accept header is not supported.

The Accept header asks for a format we do not send. Ask for JSON with a supported Accept value.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [NotAcceptableErrorResponse](https://docs.envoapi.com/api/schemas/NotAcceptableErrorResponse.md)

### 415

The Content-Type in your request is not supported.

The request declared a media type we do not accept. Remove the body or use the documented media type.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [UnsupportedMediaTypeErrorResponse](https://docs.envoapi.com/api/schemas/UnsupportedMediaTypeErrorResponse.md)

### 429

Your account has sent too many requests.

Too many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **Retry-After**: Seconds to wait before you try again. Schema: [PositiveSafeInteger](https://docs.envoapi.com/api/schemas/PositiveSafeInteger.md).

Content type: `application/json`.

Schema: [RateLimitExceededErrorResponse](https://docs.envoapi.com/api/schemas/RateLimitExceededErrorResponse.md)

### 500

A server error prevented the request from completing.

Something failed on our side. Retry only when error.retryable is true.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [InternalServerErrorResponse](https://docs.envoapi.com/api/schemas/InternalServerErrorResponse.md)

### 502

A data source returned an invalid response.

A data source sent back something we could not use. Retry with bounded backoff.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [UpstreamErrorResponse](https://docs.envoapi.com/api/schemas/UpstreamErrorResponse.md)

### 503

The service is unavailable. Check error.retryable before retrying.

Lookups are unavailable for a moment. Follow error.retryable, and Retry-After when it is present.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **Retry-After**: Seconds to wait before you try again. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [ServiceUnavailableErrorResponse](https://docs.envoapi.com/api/schemas/ServiceUnavailableErrorResponse.md)

### 504

The request timed out.

The lookup ran out of time. Retry with bounded backoff.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [UpstreamTimeoutErrorResponse](https://docs.envoapi.com/api/schemas/UpstreamTimeoutErrorResponse.md)

## Related documentation

* [Authentication](https://docs.envoapi.com/guides/authentication.md)

* [Errors](https://docs.envoapi.com/guides/errors.md)

* [Pagination](https://docs.envoapi.com/guides/pagination.md)

* [Rate limits](https://docs.envoapi.com/guides/rate-limits.md)

* [Get job details.](https://docs.envoapi.com/api/operations/getjobdetails.md)

[Documentation index](https://docs.envoapi.com/llms.txt) · [All endpoints](https://docs.envoapi.com/api/index.md)
