> ## 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

<div className="nb-home">
  <div className="nb-wrap">
    <div className="nbc-herocard">
      <div className="nbc-hero-left">
        <div className="nbc-bignum">08</div>

        <div className="nbc-headgroup">
          <div className="nbc-title">Developers & API.</div>
          <div className="nbc-introtext">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.</div>

          <div className="nbc-ctarow">
            <a className="nbc-startbtn" href="/docs/using-the-api">Start at 08.1 →</a>
            <span className="nbc-ctameta">30 articles · 4 chapters</span>
          </div>
        </div>
      </div>

      <div className="nbc-usepanel">
        <div className="nbc-usepanel-label">What you'll do</div>
        <span className="nbc-use"><span className="nbc-check">✓</span>Send orders and spend programmatically</span>
        <span className="nbc-use"><span className="nbc-check">✓</span>Export attribution data, metrics, and breakdowns to your own systems</span>
        <span className="nbc-use"><span className="nbc-check">✓</span>Authenticate and test in UAT before touching production</span>
      </div>
    </div>

    <div className="nbc-chap">
      <div className="nbc-chaphead"><span className="nbc-chapnum">08.1</span><span className="nbc-chaptitle">Using the API</span><span className="nbc-chapmeta">4 articles</span></div>

      <div className="nbg-grid">
        <a className="nbg-card" href="/docs/using-the-api"><span className="nbg-icon"><Icon icon="book-open" size={18} /></span><span className="nbg-num">01</span><span className="nbg-title">Using the API</span><span className="nbg-foot"><span className="nb-arrow">→</span></span></a>
        <a className="nbg-card" href="/docs/authentication"><span className="nbg-icon"><Icon icon="key" size={18} /></span><span className="nbg-num">02</span><span className="nbg-title">Authentication</span><span className="nbg-foot"><span className="nb-arrow">→</span></span></a>
        <a className="nbg-card" href="/docs/environments"><span className="nbg-icon"><Icon icon="server" size={18} /></span><span className="nbg-num">03</span><span className="nbg-title">Environments</span><span className="nbg-foot"><span className="nb-arrow">→</span></span></a>
        <a className="nbg-card" href="/docs/errors"><span className="nbg-icon"><Icon icon="triangle-exclamation" size={18} /></span><span className="nbg-num">04</span><span className="nbg-title">Errors</span><span className="nbg-foot"><span className="nb-arrow">→</span></span></a>
      </div>
    </div>

    <div className="nbc-chap">
      <div className="nbc-chaphead"><span className="nbc-chapnum">08.2</span><span className="nbc-chaptitle">Orders API</span><span className="nbc-chapmeta">9 articles</span></div>

      <div className="nbc-grid" style={{gridTemplateRows: "repeat(5, auto)", gridAutoFlow: "column"}}>
        <a className="nbc-cell" href="/docs/orders-api"><span className="nbc-cell-num">01</span><span className="nbc-cell-title">Orders API</span></a>
        <a className="nbc-cell" href="/docs/order-definition"><span className="nbc-cell-num">02</span><span className="nbc-cell-title">Order Definition</span></a>
        <a className="nbc-cell" href="/docs/hashing-customer-data"><span className="nbc-cell-num">03</span><span className="nbc-cell-title">Hashing Customer Data</span></a>
        <a className="nbc-cell" href="/reference/post_orders-1"><span className="nbc-cell-num">04</span><span className="nbc-cell-title">Upsert a list of orders to Northbeam</span></a>
        <a className="nbc-cell" href="/reference/get_orders-1"><span className="nbc-cell-num">05</span><span className="nbc-cell-title">Fetch a list of orders</span></a>
        <a className="nbc-cell" href="/reference/patchorders"><span className="nbc-cell-num">06</span><span className="nbc-cell-title">Partially update existing orders</span></a>
        <a className="nbc-cell" href="/reference/addorderaliases"><span className="nbc-cell-num">07</span><span className="nbc-cell-title">Add aliases to existing orders</span></a>
        <a className="nbc-cell" href="/reference/post_orders"><span className="nbc-cell-num">08</span><span className="nbc-cell-title">Upsert a list of orders to Northbeam (V1, deprecated)</span></a>
        <a className="nbc-cell" href="/reference/get_orders"><span className="nbc-cell-num">09</span><span className="nbc-cell-title">Fetch a list of orders</span></a>
      </div>
    </div>

    <div className="nbc-chap">
      <div className="nbc-chaphead"><span className="nbc-chapnum">08.3</span><span className="nbc-chaptitle">Spend API</span><span className="nbc-chapmeta">8 articles</span></div>

      <div className="nbc-grid" style={{gridTemplateRows: "repeat(4, auto)", gridAutoFlow: "column"}}>
        <a className="nbc-cell" href="/docs/spend-api"><span className="nbc-cell-num">01</span><span className="nbc-cell-title">Spend API</span></a>
        <a className="nbc-cell" href="/docs/spend-api-best-practices-and-limits"><span className="nbc-cell-num">02</span><span className="nbc-cell-title">Best Practices and Limits</span></a>
        <a className="nbc-cell" href="/reference/get_spend"><span className="nbc-cell-num">03</span><span className="nbc-cell-title">List spend records</span></a>
        <a className="nbc-cell" href="/reference/post_spend"><span className="nbc-cell-num">04</span><span className="nbc-cell-title">Upsert one or multiple spend records</span></a>
        <a className="nbc-cell" href="/reference/delete_spend"><span className="nbc-cell-num">05</span><span className="nbc-cell-title">Delete a spend record</span></a>
        <a className="nbc-cell" href="/reference/get_spend-hourly"><span className="nbc-cell-num">06</span><span className="nbc-cell-title">List spend records</span></a>
        <a className="nbc-cell" href="/reference/post_spend-hourly"><span className="nbc-cell-num">07</span><span className="nbc-cell-title">Upsert one or multiple hourly spend records</span></a>
        <a className="nbc-cell" href="/reference/delete_spend-hourly"><span className="nbc-cell-num">08</span><span className="nbc-cell-title">Delete a spend record</span></a>
      </div>
    </div>

    <div className="nbc-chap">
      <div className="nbc-chaphead"><span className="nbc-chapnum">08.4</span><span className="nbc-chaptitle">Data Export API</span><span className="nbc-chapmeta">9 articles</span></div>

      <div className="nbc-grid" style={{gridTemplateRows: "repeat(5, auto)", gridAutoFlow: "column"}}>
        <a className="nbc-cell" href="/docs/northbeam-api-data-export-1"><span className="nbc-cell-num">01</span><span className="nbc-cell-title">Data Export</span></a>
        <a className="nbc-cell" href="/docs/northbeam-api-data-export-gcs-export-1"><span className="nbc-cell-num">02</span><span className="nbc-cell-title">Exporting To GCS</span></a>
        <a className="nbc-cell" href="/docs/northbeam-api-data-export-s3-export-1"><span className="nbc-cell-num">03</span><span className="nbc-cell-title">Exporting To S3</span></a>
        <a className="nbc-cell" href="/docs/northbeam-api-data-export-rate-limits-1"><span className="nbc-cell-num">04</span><span className="nbc-cell-title">Rate Limits</span></a>
        <a className="nbc-cell" href="/reference/post_data-export-1"><span className="nbc-cell-num">05</span><span className="nbc-cell-title">Create a data export config</span></a>
        <a className="nbc-cell" href="/reference/get_data-export-result-export-id-1"><span className="nbc-cell-num">06</span><span className="nbc-cell-title">Fetch a data export result</span></a>
        <a className="nbc-cell" href="/reference/get_metrics-1"><span className="nbc-cell-num">07</span><span className="nbc-cell-title">Fetch all available metrics</span></a>
        <a className="nbc-cell" href="/reference/get_breakdowns-1"><span className="nbc-cell-num">08</span><span className="nbc-cell-title">Fetch all labels available for breakdown</span></a>
        <a className="nbc-cell" href="/reference/get_attribution-models-1"><span className="nbc-cell-num">09</span><span className="nbc-cell-title">Fetch all available attribution models</span></a>
      </div>
    </div>

    <div className="nbc-foot nbc-foot--right">
      <a className="nbc-next" href="/docs/landings/internal">Done here? 09 → Playbooks</a>
    </div>
  </div>
</div>