Skip to content

Orgs

Vendors, carriers, creditors, and debtors that BravoTran fetches from the FFS.

Operations

List updated orgs

Request

Returns a list of org identifiers, optionally filtered to those updated within a time window.

Optional. Provided as an alternative to POST /events for partners that cannot push live event notifications. Implement either the events API or the list endpoints — not both.

Response items contain only external_id. To fetch full org details, call GET /orgs/{external_id} for each entry.

Security
OAuth2.0-Partner or Bearer-Token-Partner
Query
updated_afterstring, (date-time)

Inclusive lower bound on updated_at. ISO 8601 UTC datetime (e.g., 2025-02-17T20:32:39Z). Date-only values are not accepted. Optional.

updated_beforestring, (date-time)

Exclusive upper bound on updated_at. ISO 8601 UTC datetime (e.g., 2025-02-18T20:32:39Z). Date-only values are not accepted. Optional, but if provided, updated_after is required.

curl -i -X GET \
  'https://apidocs.bravotran.com/_mock/openapi/orgs?updated_after=2025-02-17T20%3A32%3A39Z&updated_before=2025-02-18T20%3A32%3A39Z' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of org identifiers updated in the given window.

Bodyapplication/json
Array [
external_idstringrequired

The external_id of the referenced entity.

]
Response
[
  {
    "external_id": "feaa09da-9551-47f8-b30d-6e303b6ad6d5"
  },
  {
    "external_id": "9b2d1ac4-71f2-4f52-9b62-8e3e6c4a1d33"
  }
]