> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/api-document/product-guides/booking/booking-step-guides/search.md).

# Search

Atlas API search flow overview for flight offers, Get Offer, and downstream identifier handling.

{% hint style="info" %}
💬 **Need help?** If you're stuck, ask Eva in the Help Center for instant diagnostics.

<a href="https://www.atriptech.com/" class="button primary" data-icon="comments">Ask Eva</a>
{% endhint %}

Use this page to start the booking flow.

Start here when you need to:

* begin the standard booking flow
* choose between `search.do` and `getOffers.do`
* understand which identifier to keep for the next step

### FAQ

#### When should I use `search.do`?

Use `search.do` when Atlas is your main shopping entry point.

Keep the returned `routingIdentifier` for `verify.do`.

#### When should I use `getOffers.do` instead?

Use `getOffers.do` when you already know the target itinerary or need an independent price check.

Keep the returned `OfferId` for the order flow.

#### What request limit applies to `search.do`?

`search.do` uses `10 QPS` by default.

Over-limit requests return Atlas error code `429`.

Honor the returned `retryAfter` value before retrying.

#### Why does ATRIP show an offer that the API cannot find?

ATRIP requests a live airline quote when no matching cached result exists.

The Atlas API returns offers from the available cache only.

An ATRIP live search stores the returned offer in the cache.

The API can return that offer after ATRIP populates the cache.

This behavior applies to all API customers and airlines.

Before comparing results, use identical itinerary, date, passenger, and cabin parameters.

Do not treat an API no-result response as proof that no airline offer exists.

### Search request limits

Atlas counts `search.do` in a rolling 1-second window.

Use `10 QPS` as the default limit unless Atlas configured a different tier for your account.

#### What counts

These requests count:

* successful searches
* no-result searches
* business failures, airline failures, and cache-hit responses

These requests do not count:

* requests rejected by request-limit governance
* authentication, permission, or validation failures

#### How to avoid `429`

Use local cache when possible.

Collapse duplicate searches.

Back off with the returned `retryAfter` value before retrying.

### What this page covers

* Standard offer search
* Independent Get Offer lookup
* Offer polling and request follow-up

### Main APIs

* `search.do`
* `getOffers.do`

### Key outputs

* `routingIdentifier` for standard verify flow
* `OfferId` for Get Offer order flow
* Offer data for downstream selection

### Which identifier should you keep?

Keep the identifier that matches the flow:

* `routingIdentifier` for the standard search → verify flow
* `OfferId` for the Get Offer → order flow

Do not mix identifiers across flows.

### Use this when you need

* A standard search-to-book flow
* An independent offer lookup without standard search

### What comes next?

#### Standard flow

Call [Verify](https://resources.atriptech.com/api-document/product-guides/booking/booking-step-guides/verify.md) with `routingIdentifier`.

#### Get Offer flow

Continue with [Get Offer](https://resources.atriptech.com/api-document/product-guides/booking/booking-step-guides/get-offer.md) and then create the order with `OfferId`.

### Related pages

* [Get Offer](https://resources.atriptech.com/api-document/product-guides/booking/booking-step-guides/get-offer.md)
* [Verify](https://resources.atriptech.com/api-document/product-guides/booking/booking-step-guides/verify.md)
* [Sandbox Access](https://resources.atriptech.com/api-document/readme-1/making-requests.md)
* [Booking APIs](https://resources.atriptech.com/api-document/api-reference/booking-apis.md)

### Full API reference

See endpoint-level details here:

* [Search](https://resources.atriptech.com/api-document/api-reference/booking-apis/search.md)
* [Get Offer](https://resources.atriptech.com/api-document/api-reference/booking-apis/get-offer.md)
