> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northbeam.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Developers & API

> Guidance for Using the Northbeam Orders API

Northbeam's APIs for sending data in and getting data out — orders, spend, and exports — plus the MCP server for querying your data in natural language. Start with Using the API for authentication and environments, then jump to the API your task needs.

## What you'll do

* Send orders and spend programmatically
* Export attribution data, metrics, and breakdowns to your own systems
* Authenticate and test in UAT before touching production

## Using the API

<div className="nb-linklist">
  <a href="/docs/using-the-api"><Icon icon="book-open" size={16} /><span>Using the API</span></a>
  <a href="/docs/authentication"><Icon icon="key" size={16} /><span>Authentication</span></a>
  <a href="/docs/environments"><Icon icon="server" size={16} /><span>Environments</span></a>
  <a href="/docs/errors"><Icon icon="triangle-exclamation" size={16} /><span>Errors</span></a>
</div>

## Orders API

<div className="nb-linklist">
  <a href="/docs/orders-api"><Icon icon="receipt" size={16} /><span>Orders API</span></a>
  <a href="/docs/order-definition"><Icon icon="file-lines" size={16} /><span>Order Definition</span></a>
  <a href="/docs/hashing-customer-data"><Icon icon="lock" size={16} /><span>Hashing Customer Data</span></a>
  <a href="/reference/post_orders-1"><span className="nb-method nb-method-post">POST</span><span>Upsert a list of orders to Northbeam</span></a>
  <a href="/reference/get_orders-1"><span className="nb-method nb-method-get">GET</span><span>Fetch a list of orders</span></a>
  <a href="/reference/patchorders"><span className="nb-method nb-method-patch">PATCH</span><span>Partially update existing orders</span></a>
  <a href="/reference/addorderaliases"><span className="nb-method nb-method-post">POST</span><span>Add aliases to existing orders</span></a>
  <a href="/reference/post_orders"><span className="nb-method nb-method-post">POST</span><span>Upsert a list of orders to Northbeam (V1, deprecated)</span></a>
  <a href="/reference/get_orders"><span className="nb-method nb-method-get">GET</span><span>Fetch a list of orders (V1)</span></a>
</div>

## Spend API

<div className="nb-linklist">
  <a href="/docs/spend-api"><Icon icon="money-bill" size={16} /><span>Spend API</span></a>
  <a href="/docs/spend-api-best-practices-and-limits"><Icon icon="gauge-high" size={16} /><span>Best Practices and Limits</span></a>
  <a href="/reference/get_spend"><span className="nb-method nb-method-get">GET</span><span>List spend records</span></a>
  <a href="/reference/post_spend"><span className="nb-method nb-method-post">POST</span><span>Upsert one or multiple spend records</span></a>
  <a href="/reference/delete_spend"><span className="nb-method nb-method-delete">DEL</span><span>Delete a spend record</span></a>
  <a href="/reference/get_spend-hourly"><span className="nb-method nb-method-get">GET</span><span>List spend records (hourly)</span></a>
  <a href="/reference/post_spend-hourly"><span className="nb-method nb-method-post">POST</span><span>Upsert one or multiple hourly spend records</span></a>
  <a href="/reference/delete_spend-hourly"><span className="nb-method nb-method-delete">DEL</span><span>Delete a spend record (hourly)</span></a>
</div>

## Data Export API

<div className="nb-linklist">
  <a href="/docs/northbeam-api-data-export-1"><Icon icon="file-export" size={16} /><span>Data Export</span></a>
  <a href="/docs/northbeam-api-data-export-gcs-export-1"><Icon icon="cloud" size={16} /><span>Exporting To GCS</span></a>
  <a href="/docs/northbeam-api-data-export-s3-export-1"><Icon icon="cloud-arrow-up" size={16} /><span>Exporting To S3</span></a>
  <a href="/docs/northbeam-api-data-export-rate-limits-1"><Icon icon="gauge-simple-high" size={16} /><span>Rate Limits</span></a>
  <a href="/reference/post_data-export-1"><span className="nb-method nb-method-post">POST</span><span>Create a data export config</span></a>
  <a href="/reference/get_data-export-result-export-id-1"><span className="nb-method nb-method-get">GET</span><span>Fetch a data export result</span></a>
  <a href="/reference/get_metrics-1"><span className="nb-method nb-method-get">GET</span><span>Fetch all available metrics</span></a>
  <a href="/reference/get_breakdowns-1"><span className="nb-method nb-method-get">GET</span><span>Fetch all labels available for breakdown</span></a>
  <a href="/reference/get_attribution-models-1"><span className="nb-method nb-method-get">GET</span><span>Fetch all available attribution models</span></a>
</div>

***

**Next section:** [Playbooks](/docs/landings/internal)