USAspending API ReferenceIndependent
Try the API

Allocation Transfer Agency Identifier

POST/api/v2/autocomplete/accounts/ata/
Powers Search filter pickers on usaspending.gov How Advanced Search works

This endpoint powers the USAspending.gov Allocation Transfer Agency Identifier (ATA) autocomplete in the Advanced Search -> Program Source -> Treasury Account filter.

List of potential Allocation Transfer Agency Identifiers

Request

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/ata/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "ata": "02"
  },
  "limit": 3
}'

Request body

The filters object is shared by every search endpoint. The filter object explains each filter with examples.

  • filtersobject · ComponentFiltersRequired

    Each component listed here may be omitted, null, or a string value. If omitted, no filtering will be performed on that component. If null, the filter will include account numbers missing that component. If a string, the filter will perform an exact match on account numbers where that component matches the string provided except in the case of ata where a partial match will be performed on the ata component starting with the provided value.

    • ata (optional, string, nullable) Allocation Transfer Agency Identifier (3 characters). TAS only.

    • aid (optional, string, nullable) Agency Identifier (3 characters).

    • bpoa (optional, string, nullable) Beginning Period of Availability (4 characters). TAS only.

    • epoa (optional, string, nullable) Ending Period of Availability (4 characters). TAS only.

    • a (optional, string, nullable) Availability Type Code (1 character). Will either be 'X' or null. TAS only.

    • main (optional, string, nullable) Main Account Code (4 characters).

    • sub (optional, string, nullable) Sub Account Code (3 characters). TAS only.

  • limitnumber

    Number of results to return (min: 1, max: 500)

    Default 10

Try it

Runs against the live API. Responses are real data.

POST/api/v2/autocomplete/accounts/ata/

Response · 200

  • resultsarray of ATAMatchRequired3 fields
    • atastringRequired
    • agency_namestringRequiredNullable
    • agency_abbreviationstringRequiredNullable
Example response
{
  "results": [
    {
      "ata": "020",
      "agency_name": "Department of the Treasury",
      "agency_abbreviation": "TREAS"
    },
    {
      "ata": "021",
      "agency_name": "Department of the Army",
      "agency_abbreviation": null
    },
    {
      "ata": "023",
      "agency_name": "U.S. Tax Court",
      "agency_abbreviation": "USTAXCOURT"
    }
  ]
}

Recent changes

Generated from contracts/v2/autocomplete/accounts/ata.md in the USAspending API repo.

Loading…