Beginning Period of Availability

Request

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/bpoa/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "bpoa": "201"
  },
  "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 bpoa where a partial match will be performed on the bpoa 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

Response · 200

• resultsarray of stringRequired

{
  "results": [
    "2010",
    "2011",
    "2012"
  ]
}

Recent changes

• July 21, 2026DEV-15418: Update API contracts for dredd failures
• August 26, 2019Mentioned in the August 26, 2019 release notes

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