US African Development Foundation

US African Development Foundation Awards API

USADF grant award data

Documentation GitHub OpenAPI

Operations 2

POST /api/v2/search/spending_by_award/ USADF Search Grant Awards #

GET /api/v2/awards/{award_id}/ USADF Get Award Details #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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/us-african-development-foundation-awards-api"

All apis

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

Discovery needs no key. Ratings and market analysis are Pro.

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: USADF Grants Data Awards API
  description: Access to US African Development Foundation (USADF) grant award data through the USASpending.gov API. Provides programmatic access to USADF grants, awards, recipients, and spending profiles as reported to the federal awards transparency system under the Digital Accountability and Transparency (DATA) Act. USADF data uses agency code CGAC 166. This spec represents the USADF-relevant subset of the USASpending.gov API surface.
  version: 1.0.0
  contact:
    name: USASpending Help Desk
    url: https://api.usaspending.gov
    email: usaspending.help@fiscal.treasury.gov
  x-generated-from: documentation
servers:
- url: https://api.usaspending.gov
  description: USASpending.gov API
security: []
tags:
- name: Awards
  description: USADF grant award data
paths:
  /api/v2/search/spending_by_award/:
    post:
      operationId: searchAwards
      summary: USADF Search Grant Awards
      description: Search for USADF grant awards using the USASpending API. Filter by award type, recipient country, time period, and other criteria. Use agencies filter with USADF toptier_code "166" to retrieve USADF awards.
      tags:
      - Awards
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AwardSearchRequest'
            examples:
              searchAwardsRequestExample:
                summary: Default searchAwards request
                x-microcks-default: true
                value:
                  filters:
                    agencies:
                    - type: awarding
                      tier: toptier
                      name: African Development Foundation
                    award_type_codes:
                    - '02'
                    - '03'
                    - '04'
                    time_period:
                    - start_date: '2023-01-01'
                      end_date: '2023-12-31'
                  fields:
                  - Award ID
                  - Recipient Name
                  - Award Amount
                  - Description
                  - Place of Performance State Code
                  limit: 25
                  page: 1
                  sort: Award Amount
                  order: desc
      responses:
        '200':
          description: Grant award search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AwardSearchResponse'
              examples:
                searchAwards200Example:
                  summary: Default searchAwards 200 response
                  x-microcks-default: true
                  value:
                    limit: 25
                    results:
                    - internal_id: ASST_NON_166GH21LE0001
                      Award ID: 166GH21LE0001
                      Recipient Name: GHANA GRASSROOTS ENTERPRISE
                      Award Amount: 200000.0
                      Description: Community enterprise grant for agricultural cooperative development
                      Place of Performance State Code: GH
                    page_metadata:
                      page: 1
                      hasNext: true
                      total: 180
        '422':
          description: Validation error in request body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/v2/awards/{award_id}/:
    get:
      operationId: getAward
      summary: USADF Get Award Details
      description: Retrieve detailed information for a specific USADF grant award by its USASpending award identifier. Returns full award details including recipient, place of performance, funding agency, and transaction history.
      tags:
      - Awards
      parameters:
      - name: award_id
        in: path
        required: true
        description: USASpending award identifier
        schema:
          type: string
        example: ASST_NON_166GH21LE0001
      responses:
        '200':
          description: Award details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Award'
              examples:
                getAward200Example:
                  summary: Default getAward 200 response
                  x-microcks-default: true
                  value:
                    id: ASST_NON_166GH21LE0001
                    generated_unique_award_id: ASST_NON_166GH21LE0001
                    type: '04'
                    type_description: Project Grant
                    category: grant
                    description: Community enterprise grant for agricultural cooperative development
                    total_obligation: 200000.0
                    base_and_all_options_value: 200000.0
                    period_of_performance_start_date: '2021-06-01'
                    period_of_performance_current_end_date: '2023-05-31'
                    awarding_agency:
                      toptier_agency:
                        name: African Development Foundation
                        abbreviation: USADF
                        code: '166'
                    recipient:
                      recipient_name: GHANA GRASSROOTS ENTERPRISE
                      recipient_uei: GH123456789
                    place_of_performance:
                      country_name: Ghana
                      country_code: GH
        '404':
          description: Award not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    AwardSearchRequest:
      type: object
      description: Request body for searching USADF grant awards
      properties:
        filters:
          type: object
          description: Search filters
          properties:
            agencies:
              type: array
              description: Agency filters
              items:
                type: object
                properties:
                  type:
                    type: string
                    example: awarding
                  tier:
                    type: string
                    example: toptier
                  name:
                    type: string
                    example: African Development Foundation
            award_type_codes:
              type: array
              description: Award type codes (02=Block Grant, 03=Formula Grant, 04=Project Grant)
              items:
                type: string
              example:
              - '02'
              - '03'
              - '04'
            time_period:
              type: array
              description: Date range filters
              items:
                type: object
                properties:
                  start_date:
                    type: string
                    format: date
                    example: '2023-01-01'
                  end_date:
                    type: string
                    format: date
                    example: '2023-12-31'
        fields:
          type: array
          description: Fields to include in results
          items:
            type: string
          example:
          - Award ID
          - Recipient Name
          - Award Amount
        limit:
          type: integer
          description: Results per page
          example: 25
        page:
          type: integer
          description: Page number
          example: 1
        sort:
          type: string
          description: Sort field
          example: Award Amount
        order:
          type: string
          description: Sort order
          enum:
          - asc
          - desc
          example: desc
    RecipientSummary:
      type: object
      description: Summary of a grant recipient
      properties:
        recipient_name:
          type: string
          description: Organization name
          example: GHANA GRASSROOTS ENTERPRISE
        recipient_uei:
          type: string
          description: Unique Entity Identifier
          example: GH123456789
    AwardSearchResponse:
      type: object
      description: Search results for USADF grant awards
      properties:
        limit:
          type: integer
          description: Page size
          example: 25
        results:
          type: array
          description: Award search results
          items:
            type: object
        page_metadata:
          type: object
          description: Pagination metadata
          properties:
            page:
              type: integer
              example: 1
            hasNext:
              type: boolean
              example: true
            total:
              type: integer
              example: 180
    APIError:
      type: object
      description: API error response
      properties:
        detail:
          type: string
          description: Error detail message
          example: Award not found.
        status:
          type: integer
          description: HTTP status code
          example: 404
    PlaceOfPerformance:
      type: object
      description: Geographic location for award performance
      properties:
        country_name:
          type: string
          description: Country name
          example: Ghana
        country_code:
          type: string
          description: ISO country code
          example: GH
        city_name:
          type: string
          description: City name
          example: Accra
    Award:
      type: object
      description: A USADF grant award record from USASpending
      properties:
        id:
          type: string
          description: USASpending internal award identifier
          example: ASST_NON_166GH21LE0001
        generated_unique_award_id:
          type: string
          description: Generated unique award identifier
          example: ASST_NON_166GH21LE0001
        type:
          type: string
          description: Award type code
          example: '04'
        type_description:
          type: string
          description: Award type description
          example: Project Grant
        category:
          type: string
          description: Award category
          enum:
          - grant
          - contract
          - loan
          - direct payment
          - other
          example: grant
        description:
          type: string
          description: Award description
          example: Community enterprise grant for agricultural cooperative development
        total_obligation:
          type: number
          description: Total obligated amount in USD
          example: 200000.0
        base_and_all_options_value:
          type: number
          description: Base and all options value in USD
          example: 200000.0
        period_of_performance_start_date:
          type: string
          format: date
          description: Grant performance start date
          example: '2021-06-01'
        period_of_performance_current_end_date:
          type: string
          format: date
          description: Grant performance end date
          example: '2023-05-31'
        awarding_agency:
          type: object
          description: Awarding agency details
          properties:
            toptier_agency:
              type: object
              properties:
                name:
                  type: string
                  example: African Development Foundation
                abbreviation:
                  type: string
                  example: USADF
                code:
                  type: string
                  example: '166'
        recipient:
          $ref: '#/components/schemas/RecipientSummary'
        place_of_performance:
          $ref: '#/components/schemas/PlaceOfPerformance'
externalDocs:
  description: USASpending API Documentation
  url: https://api.usaspending.gov/docs/endpoints