find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/piloterr-com:piloterr-com-usaspending-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Piloterr API Reference Usaspending API
  description: Complete API reference documentation.
  version: 1.0.0
servers:
- url: https://api.piloterr.com
  description: API Server
tags:
- name: Usaspending
paths:
  /v2/usaspending/award:
    get:
      summary: USAspending Award
      description: 'Fetch one US federal award by its generated id or by a usaspending.gov award URL. Amounts are a number plus a display string.


        **Credit cost:** 1 credit per call'
      operationId: get-usaspending-award
      security:
      - ApiKeyAuth: []
      parameters:
      - name: query
        in: query
        required: true
        description: 'Required. Generated award id or a usaspending.gov/award URL. Example: CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-.'
        schema:
          type: string
          description: 'Required. Generated award id or a usaspending.gov/award URL. Example: CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-.'
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  url:
                    type: string
                  city:
                    type: string
                  state:
                    type: string
                  country:
                    type: string
                  award_id:
                    type: string
                  category:
                    type: string
                  end_date:
                    type: string
                  psc_code:
                    type: string
                  type_code:
                    type: string
                  award_type:
                    type: string
                  naics_code:
                    type: string
                  start_date:
                    type: string
                  date_signed:
                    type: string
                  description:
                    type: string
                  award_amount:
                    type: integer
                  recipient_uei:
                    type: string
                  amount_display:
                    type: string
                  funding_agency:
                    type: string
                  recipient_name:
                    type: string
                  subaward_count:
                    type: integer
                  awarding_agency:
                    type: string
                  psc_description:
                    type: string
                  naics_description:
                    type: string
                  awarding_sub_agency:
                    type: string
                  generated_internal_id:
                    type: string
              examples:
                NASA contract:
                  value:
                    url: https://www.usaspending.gov/award/CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-/
                    city: BALTIMORE
                    state: MD
                    country: UNITED STATES
                    award_id: GSFC0198106DNAS526555
                    category: contract
                    end_date: '2026-10-31'
                    psc_code: AR21
                    type_code: D
                    award_type: DEFINITIVE CONTRACT
                    naics_code: '333314'
                    start_date: '1987-09-15'
                    date_signed: '1987-09-15'
                    description: 'THE PRIMARY ACTIVITIES COVERED BY THIS EFFORT INCLUDE THE FINAL SERVICING MISSION AND SUBSEQUENT OPERATIONS THROUGH END-OF-MISSION. THESE ACTIVITIES INCLUDE: A. SCIENCE PROGRAM IMPLEMENTATION INCLUDING: MISSION PLANNING SUPPORT, SCIENCE PROGRAM DEFINITION SUPPORT, MANAGEMENT OF THE PROPOSAL SELECTION, TIME ALLOCATION, AND GRANT AWARD COMMITTEE PROCESSES, AND SCIENCE COMMUNITY OUTREACH. B. ROUTINE SCIENCE OPERATIONS INCLUDING: PROPOSAL GENERATION AND RECEIPT, OBSERVATION PLANNING AND SCHEDULING, UPDATING INSTRUMENT HANDBOOKS, OBSERVING AND USER SUPPORT, DATA PROCESSING AND PRODUCT GENERATION, ARCHIVAL AND DATA DISTRIBUTION SERVICES, CALIBRATION ASSISTANCE AND DATA ANALYSIS, ANOMALY INVESTIGATION SUPPORT, USER GRANT ADMINISTRATION, OBSERVER ASSISTANCE AND ENGINEERING OPERATIONS SUPPORT. C.'
                    award_amount: 2533788480
                    recipient_uei: W1NBN156CYF9
                    amount_display: $2,533,788,480.00
                    funding_agency: National Aeronautics and Space Administration
                    recipient_name: ASSOCIATION OF UNIVERSITIES FOR RESEARCH IN ASTRONOMY, INC.
                    subaward_count: 9
                    awarding_agency: National Aeronautics and Space Administration
                    psc_description: 'R&D- SPACE: SCIENCE/APPLICATIONS (BASIC RESEARCH)'
                    naics_description: Optical Instrument and Lens Manufacturing
                    awarding_sub_agency: National Aeronautics and Space Administration
                    generated_internal_id: CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Usaspending
    post:
      summary: USAspending Award
      description: 'Fetch one US federal award by its generated id or by a usaspending.gov award URL. Amounts are a number plus a display string.


        **Credit cost:** 1 credit per call'
      operationId: post-usaspending-award
      security:
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: 'Required. Generated award id or a usaspending.gov/award URL. Example: CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-.'
              required:
              - query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  url:
                    type: string
                  city:
                    type: string
                  state:
                    type: string
                  country:
                    type: string
                  award_id:
                    type: string
                  category:
                    type: string
                  end_date:
                    type: string
                  psc_code:
                    type: string
                  type_code:
                    type: string
                  award_type:
                    type: string
                  naics_code:
                    type: string
                  start_date:
                    type: string
                  date_signed:
                    type: string
                  description:
                    type: string
                  award_amount:
                    type: integer
                  recipient_uei:
                    type: string
                  amount_display:
                    type: string
                  funding_agency:
                    type: string
                  recipient_name:
                    type: string
                  subaward_count:
                    type: integer
                  awarding_agency:
                    type: string
                  psc_description:
                    type: string
                  naics_description:
                    type: string
                  awarding_sub_agency:
                    type: string
                  generated_internal_id:
                    type: string
              examples:
                NASA contract:
                  value:
                    url: https://www.usaspending.gov/award/CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-/
                    city: BALTIMORE
                    state: MD
                    country: UNITED STATES
                    award_id: GSFC0198106DNAS526555
                    category: contract
                    end_date: '2026-10-31'
                    psc_code: AR21
                    type_code: D
                    award_type: DEFINITIVE CONTRACT
                    naics_code: '333314'
                    start_date: '1987-09-15'
                    date_signed: '1987-09-15'
                    description: 'THE PRIMARY ACTIVITIES COVERED BY THIS EFFORT INCLUDE THE FINAL SERVICING MISSION AND SUBSEQUENT OPERATIONS THROUGH END-OF-MISSION. THESE ACTIVITIES INCLUDE: A. SCIENCE PROGRAM IMPLEMENTATION INCLUDING: MISSION PLANNING SUPPORT, SCIENCE PROGRAM DEFINITION SUPPORT, MANAGEMENT OF THE PROPOSAL SELECTION, TIME ALLOCATION, AND GRANT AWARD COMMITTEE PROCESSES, AND SCIENCE COMMUNITY OUTREACH. B. ROUTINE SCIENCE OPERATIONS INCLUDING: PROPOSAL GENERATION AND RECEIPT, OBSERVATION PLANNING AND SCHEDULING, UPDATING INSTRUMENT HANDBOOKS, OBSERVING AND USER SUPPORT, DATA PROCESSING AND PRODUCT GENERATION, ARCHIVAL AND DATA DISTRIBUTION SERVICES, CALIBRATION ASSISTANCE AND DATA ANALYSIS, ANOMALY INVESTIGATION SUPPORT, USER GRANT ADMINISTRATION, OBSERVER ASSISTANCE AND ENGINEERING OPERATIONS SUPPORT. C.'
                    award_amount: 2533788480
                    recipient_uei: W1NBN156CYF9
                    amount_display: $2,533,788,480.00
                    funding_agency: National Aeronautics and Space Administration
                    recipient_name: ASSOCIATION OF UNIVERSITIES FOR RESEARCH IN ASTRONOMY, INC.
                    subaward_count: 9
                    awarding_agency: National Aeronautics and Space Administration
                    psc_description: 'R&D- SPACE: SCIENCE/APPLICATIONS (BASIC RESEARCH)'
                    naics_description: Optical Instrument and Lens Manufacturing
                    awarding_sub_agency: National Aeronautics and Space Administration
                    generated_internal_id: CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Usaspending
  /v2/usaspending/search:
    get:
      summary: USAspending Search
      description: 'Search US federal awards by keyword. award_type selects one group: contract (default), grant, idv, or loan. Amounts are a number plus a display string.


        **Credit cost:** 1 credit per call'
      operationId: get-usaspending-search
      security:
      - ApiKeyAuth: []
      parameters:
      - name: query
        in: query
        required: true
        description: 'Required. Keyword or a usaspending.gov search URL. Example: software. An award URL returns 400.'
        schema:
          type: string
          description: 'Required. Keyword or a usaspending.gov search URL. Example: software. An award URL returns 400.'
      - name: award_type
        in: query
        required: false
        description: 'Optional. One group: contract (default when omitted), grant, idv, or loan. Example: grant.'
        schema:
          type: string
          description: 'Optional. One group: contract (default when omitted), grant, idv, or loan. Example: grant.'
      - name: page
        in: query
        required: false
        description: 'Optional. Page number from 1. Example: 2. Defaults to 1. Each page has 10 awards. total_results stays null.'
        schema:
          type: number
          description: 'Optional. Page number from 1. Example: 2. Defaults to 1. Each page has 10 awards. total_results stays null.'
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        city:
                          nullable: true
                        state:
                          nullable: true
                        award_id:
                          type: string
                        end_date:
                          type: string
                        psc_code:
                          nullable: true
                        award_type:
                          nullable: true
                        naics_code:
                          nullable: true
                        start_date:
                          type: string
                        description:
                          type: string
                        award_amount:
                          type: integer
                        amount_display:
                          type: string
                        funding_agency:
                          type: string
                        recipient_name:
                          type: string
                        awarding_agency:
                          type: string
                        awarding_sub_agency:
                          type: string
                        generated_internal_id:
                          type: string
                  pagination:
                    type: object
                    properties:
                      next:
                        type: string
                      page:
                        type: integer
                      per_page:
                        type: integer
                      total_pages:
                        nullable: true
                      total_results:
                        nullable: true
              examples:
                software contracts:
                  value:
                    results:
                    - url: https://www.usaspending.gov/award/CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-/
                      city: null
                      state: null
                      award_id: GSFC0198106DNAS526555
                      end_date: '2026-10-31'
                      psc_code: null
                      award_type: null
                      naics_code: null
                      start_date: '1987-09-15'
                      description: 'THE PRIMARY ACTIVITIES COVERED BY THIS EFFORT INCLUDE THE FINAL SERVICING MISSION AND SUBSEQUENT OPERATIONS THROUGH END-OF-MISSION. THESE ACTIVITIES INCLUDE: A. SCIENCE PROGRAM IMPLEMENTATION INCLUDING: MISSION PLANNING SUPPORT, SCIENCE PROGRAM DEFINITION SUPPORT, MANAGEMENT OF THE PROPOSAL SELECTION, TIME ALLOCATION, AND GRANT AWARD COMMITTEE PROCESSES, AND SCIENCE COMMUNITY OUTREACH. B. ROUTINE SCIENCE OPERATIONS INCLUDING: PROPOSAL GENERATION AND RECEIPT, OBSERVATION PLANNING AND SCHEDULING, UPDATING INSTRUMENT HANDBOOKS, OBSERVING AND USER SUPPORT, DATA PROCESSING AND PRODUCT GENERATION, ARCHIVAL AND DATA DISTRIBUTION SERVICES, CALIBRATION ASSISTANCE AND DATA ANALYSIS, ANOMALY INVESTIGATION SUPPORT, USER GRANT ADMINISTRATION, OBSERVER ASSISTANCE AND ENGINEERING OPERATIONS SUPPORT. C.'
                      award_amount: 2533788480
                      amount_display: $2,533,788,480.00
                      funding_agency: National Aeronautics and Space Administration
                      recipient_name: ASSOCIATION OF UNIVERSITIES FOR RESEARCH IN ASTRONOMY, INC.
                      awarding_agency: National Aeronautics and Space Administration
                      awarding_sub_agency: National Aeronautics and Space Administration
                      generated_internal_id: CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-
                    pagination:
                      next: https://www.usaspending.gov/search/?keywords=software&page=2
                      page: 1
                      per_page: 10
                      total_pages: null
                      total_results: null
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Usaspending
    post:
      summary: USAspending Search
      description: 'Search US federal awards by keyword. award_type selects one group: contract (default), grant, idv, or loan. Amounts are a number plus a display string.


        **Credit cost:** 1 credit per call'
      operationId: post-usaspending-search
      security:
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: 'Required. Keyword or a usaspending.gov search URL. Example: software. An award URL returns 400.'
                award_type:
                  type: string
                  description: 'Optional. One group: contract (default when omitted), grant, idv, or loan. Example: grant.'
                page:
                  type: number
                  description: 'Optional. Page number from 1. Example: 2. Defaults to 1. Each page has 10 awards. total_results stays null.'
              required:
              - query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        city:
                          nullable: true
                        state:
                          nullable: true
                        award_id:
                          type: string
                        end_date:
                          type: string
                        psc_code:
                          nullable: true
                        award_type:
                          nullable: true
                        naics_code:
                          nullable: true
                        start_date:
                          type: string
                        description:
                          type: string
                        award_amount:
                          type: integer
                        amount_display:
                          type: string
                        funding_agency:
                          type: string
                        recipient_name:
                          type: string
                        awarding_agency:
                          type: string
                        awarding_sub_agency:
                          type: string
                        generated_internal_id:
                          type: string
                  pagination:
                    type: object
                    properties:
                      next:
                        type: string
                      page:
                        type: integer
                      per_page:
                        type: integer
                      total_pages:
                        nullable: true
                      total_results:
                        nullable: true
              examples:
                software contracts:
                  value:
                    results:
                    - url: https://www.usaspending.gov/award/CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-/
                      city: null
                      state: null
                      award_id: GSFC0198106DNAS526555
                      end_date: '2026-10-31'
                      psc_code: null
                      award_type: null
                      naics_code: null
                      start_date: '1987-09-15'
                      description: 'THE PRIMARY ACTIVITIES COVERED BY THIS EFFORT INCLUDE THE FINAL SERVICING MISSION AND SUBSEQUENT OPERATIONS THROUGH END-OF-MISSION. THESE ACTIVITIES INCLUDE: A. SCIENCE PROGRAM IMPLEMENTATION INCLUDING: MISSION PLANNING SUPPORT, SCIENCE PROGRAM DEFINITION SUPPORT, MANAGEMENT OF THE PROPOSAL SELECTION, TIME ALLOCATION, AND GRANT AWARD COMMITTEE PROCESSES, AND SCIENCE COMMUNITY OUTREACH. B. ROUTINE SCIENCE OPERATIONS INCLUDING: PROPOSAL GENERATION AND RECEIPT, OBSERVATION PLANNING AND SCHEDULING, UPDATING INSTRUMENT HANDBOOKS, OBSERVING AND USER SUPPORT, DATA PROCESSING AND PRODUCT GENERATION, ARCHIVAL AND DATA DISTRIBUTION SERVICES, CALIBRATION ASSISTANCE AND DATA ANALYSIS, ANOMALY INVESTIGATION SUPPORT, USER GRANT ADMINISTRATION, OBSERVER ASSISTANCE AND ENGINEERING OPERATIONS SUPPORT. C.'
                      award_amount: 2533788480
                      amount_display: $2,533,788,480.00
                      funding_agency: National Aeronautics and Space Administration
                      recipient_name: ASSOCIATION OF UNIVERSITIES FOR RESEARCH IN ASTRONOMY, INC.
                      awarding_agency: National Aeronautics and Space Administration
                      awarding_sub_agency: National Aeronautics and Space Administration
                      generated_internal_id: CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-
                    pagination:
                      next: https://www.usaspending.gov/search/?keywords=software&page=2
                      page: 1
                      per_page: 10
                      total_pages: null
                      total_results: null
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Usaspending
components:
  parameters:
    fields:
      name: fields
      in: query
      required: false
      description: Comma-separated list of response fields to return, with dot notation for nested fields (e.g. `name,location.city`).
      schema:
        type: string
    is_async:
      name: is_async
      in: query
      required: false
      description: 'Run the request as a background job: the API answers `202` with a `job_id` to poll on `GET /v1/jobs/{id}`.'
      schema:
        type: boolean
        default: false
    soft_fail:
      name: soft_fail
      in: query
      required: false
      description: Return HTTP 200 even when the request fails; the error is in the `error` field of the body.
      schema:
        type: boolean
        default: false
  schemas:
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          description: Human-readable error message.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key. Include it in the x-api-key header for every request.