# Orders

The Orders API allows you to fetch a list of up to 50 recent orders or query for specific ones either by order id or by external reference, set by the partner.

This information can be used to learn order state changes in a passive-polling way. It is an alternative to subscribing to [webhooks](https://docs.blockchain.com/pay/api/webhooks), which provide automatic and instant updates.

:warning: Since this API shares sensitive data of the orders, it requires [private authentication](https://docs.blockchain.com/pay/api/partner-api/authentication#private-authentication).

{% openapi src="<https://3847274351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfFgi7ALs9ucQXxMhB7PS%2Fuploads%2F9yPk7hXpFwyVyCKfyF4d%2Fpartner_api.yaml?alt=media&token=d4b5d76f-b358-4b81-bc26-c4a41c3c88ca>" path="/v1/orders" method="get" %}
[partner\_api.yaml](https://3847274351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfFgi7ALs9ucQXxMhB7PS%2Fuploads%2F9yPk7hXpFwyVyCKfyF4d%2Fpartner_api.yaml?alt=media\&token=d4b5d76f-b358-4b81-bc26-c4a41c3c88ca)
{% endopenapi %}

{% openapi src="<https://3847274351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfFgi7ALs9ucQXxMhB7PS%2Fuploads%2F9yPk7hXpFwyVyCKfyF4d%2Fpartner_api.yaml?alt=media&token=d4b5d76f-b358-4b81-bc26-c4a41c3c88ca>" path="/v1/orders/{id}" method="get" %}
[partner\_api.yaml](https://3847274351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfFgi7ALs9ucQXxMhB7PS%2Fuploads%2F9yPk7hXpFwyVyCKfyF4d%2Fpartner_api.yaml?alt=media\&token=d4b5d76f-b358-4b81-bc26-c4a41c3c88ca)
{% endopenapi %}