# Full Download
source: https://developer.mastercard.com/bin-lookup/documentation/use-cases/get-all-bins/index.md

The `/bin-ranges` endpoint allows BIN Lookup integrators (Merchants/Acquirers/Payment Service Providers (PSPs)) to retrieve all of the most up-to-date BIN range information available.

For example, a high-volume PSP can use the full download endpoint to populate an internal BIN reference service that supports transaction routing, fraud screening, reporting, and customer support across its platform. By loading the complete dataset into a local database or cache, the business can power fast internal lookups at scale, reduce dependency on a live API call during payment processing, and make the same BIN intelligence available to multiple downstream systems.

1. **Send Initial Request:** Submit the lookup request to the BIN Lookup API using the `POST /bin-ranges` endpoint. Use the `page` and `size` parameters to retrieve the first page of account ranges.
2. **Validate Response:** Check for a HTTP 200 status code. A successful response returns a JSON array of account ranges.
3. **Parse Results:** Extract `currentPageNumber`, `totalPages`, and `totalItems` from the response.
4. **Store Results:** Add the `items` array to your local collection.
5. **Paginate:** Increment the `page` parameter and continue fetching pages until `currentPageNumber >= totalPages`.
6. **Verify:** Confirm that the total number of items downloaded matches `totalItems`.

## Example Sequence {#example-sequence}

The following shows an example sequence of the `/bin-ranges` endpoint.

![How to download all BINs](https://static.developer.mastercard.com/content/bin-lookup/uploads/allbins.svg "How to download all BINs")

## Endpoint Structure {#endpoint-structure}


API Reference: `POST /bin-ranges`

## Next Steps {#next-steps}

To learn how to use the paginated download functionality check out the [Pagination Tutorial](https://developer.mastercard.com/bin-lookup/documentation/tutorials-and-guides/pagination-tutorial/index.md).

### Useful Links {#useful-links}

* [View the full Open API specification](https://developer.mastercard.com/bin-lookup/documentation/api-section/index.md)
* [Review the API's error responses](https://developer.mastercard.com/bin-lookup/documentation/code-and-formats/index.md)