Access to USADF grant opportunity listings through the Grants.gov API. USADF posts open grant solicitations on Grants.gov for African grassroots enterprises, cooperatives, and social entrepreneurs seeking funding. Grant amounts up to $250,000 for African-led development initiatives.
openapi: 3.0.3
info:
title: USADF Grant Opportunities API
description: >-
Access to US African Development Foundation (USADF) grant opportunity listings
through the Grants.gov API. USADF posts open grant solicitations on Grants.gov
for African grassroots enterprises, cooperatives, social entrepreneurs, and
community organizations seeking funding for African-led development initiatives.
USADF uses agency code ADF on Grants.gov. This spec represents the USADF-relevant
subset of the Grants.gov API.
version: '1.0.0'
contact:
name: Grants.gov Contact Center
url: https://www.grants.gov/developers.html
x-generated-from: documentation
externalDocs:
description: Grants.gov Developer Resources
url: https://www.grants.gov/developers.html
servers:
- url: https://apply07.grants.gov/grantsws/rest
description: Grants.gov REST API
tags:
- name: Opportunities
description: USADF grant opportunity listings on Grants.gov
security: []
paths:
/opportunities/search:
post:
operationId: searchOpportunities
summary: USADF Search Grant Opportunities
description: >-
Search for USADF grant opportunities on Grants.gov. Filter by agency (ADF),
status (open, closed, archived), and other criteria. Returns USADF funding
opportunities for African grassroots enterprises and social entrepreneurs.
tags:
- Opportunities
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/OpportunitySearchRequest'
examples:
searchOpportunitiesRequestExample:
summary: Default searchOpportunities request
x-microcks-default: true
value:
agencyCode: "ADF"
oppStatus: "posted"
rows: 25
startRecordNum: 0
responses:
'200':
description: USADF grant opportunity search results
content:
application/json:
schema:
$ref: '#/components/schemas/OpportunitySearchResponse'
examples:
searchOpportunities200Example:
summary: Default searchOpportunities 200 response
x-microcks-default: true
value:
total: 3
rows: 25
startRecordNum: 0
hitCount: 3
oppHits:
- id: "USADF-2024-001"
number: "USADF-FY24-AFRICA-GRANT-001"
title: "USADF FY2024 African Enterprise Grant Program"
agencyCode: "ADF"
agencyName: "African Development Foundation"
openDate: "2024-01-15"
closeDate: "2024-03-15"
oppStatus: "posted"
description: "Grants up to $250,000 for African grassroots enterprises"
estimatedTotalProgramFunding: 5000000.00
expectedNumberOfAwards: 25
cfdaList:
- "98.001"
'400':
description: Invalid search parameters
content:
application/json:
schema:
$ref: '#/components/schemas/APIError'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/opportunities/{opportunityId}:
get:
operationId: getOpportunity
summary: USADF Get Grant Opportunity Details
description: >-
Retrieve detailed information for a specific USADF grant opportunity by
its Grants.gov opportunity ID. Returns full details including eligibility,
award amounts, application deadlines, and contact information.
tags:
- Opportunities
parameters:
- name: opportunityId
in: path
required: true
description: Grants.gov opportunity identifier
schema:
type: string
example: "USADF-2024-001"
responses:
'200':
description: Grant opportunity details
content:
application/json:
schema:
$ref: '#/components/schemas/Opportunity'
examples:
getOpportunity200Example:
summary: Default getOpportunity 200 response
x-microcks-default: true
value:
id: "USADF-2024-001"
number: "USADF-FY24-AFRICA-GRANT-001"
title: "USADF FY2024 African Enterprise Grant Program"
agencyCode: "ADF"
agencyName: "African Development Foundation"
openDate: "2024-01-15"
closeDate: "2024-03-15"
oppStatus: "posted"
synopsis: "The USADF provides grants to African grassroots enterprises, cooperatives, and community organizations promoting local economic development."
description: "Grants up to $250,000 for African grassroots enterprises"
estimatedTotalProgramFunding: 5000000.00
awardCeiling: 250000.00
awardFloor: 10000.00
expectedNumberOfAwards: 25
eligibleApplicants: "Private Institutions of Higher Education"
eligibilityExplanation: "African grassroots enterprises, cooperatives, and community organizations in eligible countries"
cfdaList:
- "98.001"
contactName: "USADF Program Officer"
contactEmail: "[email protected]"
'404':
description: Opportunity not found
content:
application/json:
schema:
$ref: '#/components/schemas/APIError'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
OpportunitySearchRequest:
type: object
description: Request body for searching USADF grant opportunities on Grants.gov
properties:
agencyCode:
type: string
description: Agency code filter (use ADF for USADF)
example: "ADF"
oppStatus:
type: string
description: Opportunity status filter
enum:
- posted
- closed
- archived
- forecasted
example: "posted"
keyword:
type: string
description: Keyword search in title and description
example: "Africa enterprise"
rows:
type: integer
description: Number of results per page
default: 25
example: 25
startRecordNum:
type: integer
description: Starting record number for pagination
default: 0
example: 0
sortBy:
type: string
description: Sort field
example: "openDate"
sortOrder:
type: string
description: Sort order
enum:
- asc
- desc
example: "desc"
OpportunitySearchResponse:
type: object
description: Search results for USADF grant opportunities
properties:
total:
type: integer
description: Total matching opportunities
example: 3
rows:
type: integer
description: Page size
example: 25
startRecordNum:
type: integer
description: Starting record number
example: 0
hitCount:
type: integer
description: Number of results returned
example: 3
oppHits:
type: array
description: List of matching opportunities
items:
$ref: '#/components/schemas/Opportunity'
Opportunity:
type: object
description: A USADF grant opportunity on Grants.gov
properties:
id:
type: string
description: Grants.gov opportunity identifier
example: "USADF-2024-001"
number:
type: string
description: Opportunity number
example: "USADF-FY24-AFRICA-GRANT-001"
title:
type: string
description: Opportunity title
example: "USADF FY2024 African Enterprise Grant Program"
agencyCode:
type: string
description: Agency code
example: "ADF"
agencyName:
type: string
description: Agency full name
example: "African Development Foundation"
openDate:
type: string
format: date
description: Application opening date
example: "2024-01-15"
closeDate:
type: string
format: date
description: Application closing deadline
example: "2024-03-15"
oppStatus:
type: string
description: Opportunity status
enum:
- posted
- closed
- archived
- forecasted
example: "posted"
synopsis:
type: string
description: Brief synopsis of the opportunity
example: "The USADF provides grants to African grassroots enterprises"
description:
type: string
description: Full opportunity description
example: "Grants up to $250,000 for African grassroots enterprises"
estimatedTotalProgramFunding:
type: number
description: Total estimated program funding in USD
example: 5000000.00
awardCeiling:
type: number
description: Maximum individual award amount in USD
example: 250000.00
awardFloor:
type: number
description: Minimum individual award amount in USD
example: 10000.00
expectedNumberOfAwards:
type: integer
description: Expected number of awards to be made
example: 25
eligibleApplicants:
type: string
description: Eligible applicant types
example: "Private Institutions of Higher Education"
eligibilityExplanation:
type: string
description: Detailed eligibility explanation
example: "African grassroots enterprises, cooperatives, and community organizations"
cfdaList:
type: array
description: CFDA (Catalog of Federal Domestic Assistance) numbers
items:
type: string
example: ["98.001"]
contactName:
type: string
description: Program officer contact name
example: "USADF Program Officer"
contactEmail:
type: string
description: Contact email address
example: "[email protected]"
APIError:
type: object
description: API error response
properties:
errorCode:
type: string
description: Error code
example: "NOT_FOUND"
errorMessage:
type: string
description: Human-readable error message
example: "Grant opportunity not found."