---
title: "Get Branch Job Accounts"
method: GET
path: "/supplier_provider/{supplier_provider_uid}/branch_job_accounts"
---

# Get Branch Job Accounts

`GET /supplier_provider/{supplier_provider_uid}/branch_job_accounts`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/supplier_provider/{supplier_provider_uid}/branch_job_accounts`
- Auth: API key in header `x-api-key`

Looks up, live from the supplier, the job accounts you can order against at one or more branches, so you can choose `preferred_job_account_number` before saving a branch with Create Supplier Branch. Pass `branch_code` (comma-separated for several branches) or, for SRS only, both `ship_to_latitude` and `ship_to_longitude` to find your SRS branches near a ship-to location; when SRS receives both coordinates they take precedence over `branch_code`. For SRS a job account is an SRS job account under your customer code, for ABC Supply it is a Ship-To account, and for QXO it is a job under the QXO account that owns the branch (each QXO entry also returns that `account_id`). ABC Supply and QXO ignore coordinates, so a coordinates-only request returns an empty list for them. The provider must exist and be `CONNECTED`; otherwise the request fails with 404 (unknown provider) or 403 (not connected or reconnect required).

## Path parameters

- `supplier_provider_uid` string, required

## Query parameters

- `branch_code` string
- `ship_to_latitude` number
- `ship_to_longitude` number

## Response `200`

200

- object
  - `type` 'success'
  - `title` string
  - `message` string
  - `data` object[]: One entry per branch. SRS and ABC Supply omit branch codes they don't recognise; QXO returns them with `account_id: null` and no job accounts.
    - `branch_code` string
    - `branch_name` string, nullable: QXO prefixes the QXO account number, e.g. `204518-Fort Worth`. `null` for a QXO branch code that matches no account.
    - `account_id` string, nullable: QXO only. The QXO account that owns the branch; `null` when the branch code matches no account.
    - `job_accounts` object[]
      - `job_account_number` union: Send as `preferred_job_account_number`. SRS returns a number.
        - string
        - integer
      - `job_account_name` string: Send as `preferred_job_account_name`.
    - `job_accounts_fetch_failed` boolean: QXO only. Present and `true` when the supplier's job list for this branch could not be read; `job_accounts` is then empty and saving this branch will fail.

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/supplier_provider/:supplier_provider_uid/branch_job_accounts/get.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)