Discovery

Search published opportunities

Returns only published opportunities. Unsupported filter values are omitted and reported in meta.invalid.

get/api/v1/search

Request

  • Base URL: https://openmedici.com
  • URL: https://openmedici.com/api/v1/search
  • Auth: none required

Query parameters

qstring

Free-text search across public opportunity and organization fields.

typestring[]

Opportunity-kind values returned by the types facet.

topicstring[]

Topic values returned by the topics facet.

fieldstring[]

Backward-compatible alias for topic.

applicantstring[]

Applicant-kind values returned by the applicants facet.

careerstring[]

Career-stage values returned by the careers facet.

audiencestring[]

Audience-focus values returned by the audiences facet.

educationstring[]

Education values returned by the education facet.

enrollmentstring[]

Enrollment values returned by the enrollments facet.

citizenshipstring[]

ISO country, M49 region, or state values returned by the citizenships facet.

residencestring[]

ISO country, M49 region, or state values returned by the residences facet.

countrystring[]

Eligible-country values returned by the countries facet.

destinationstring[]

Destination values returned by the destinations facet.

benefitstring[]

Benefit values returned by the benefits facet.

fundingShapestring[]

Funding-shape values returned by the fundingShapes facet.

durationUnitstring[]

Filter by the unit stored on a duration fact. This does not change durationMin or durationMax, which are always measured in days.

openStatestring[]

Application-state values returned by the openStates facet.

lifecyclestring[]

Program-lifecycle values returned by the lifecycles facet.

ageMinnumber

Minimum applicant age accepted by the opportunity.

ageMaxnumber

Maximum applicant age accepted by the opportunity.

deadlineFromstring date

Earliest next deadline, inclusive.

deadlineTostring date

Latest next deadline, inclusive.

rollingboolean

When true, return rolling opportunities only.

fundedboolean

When true, require published funding information.

fundingMinnumber

Minimum published funding in USD.

fundingMaxnumber

Maximum published funding in USD.

durationMinnumber

Minimum published duration in days.

durationMaxnumber

Maximum published duration in days.

openboolean

When true, require an opportunity that is currently open.

locale'en' | 'es'

Preferred public translation.

lang'en' | 'es'

Backward-compatible alias for locale. When both are present, locale takes precedence and a conflicting lang value is reported in meta.invalid.

sort'rank' | 'deadline' | 'name' | 'recent'
pageinteger
limitinteger
offsetinteger

Backward-compatible offset. When present, it takes precedence over page.

facetsboolean

Set to false to omit meta.facets. Invalid values preserve the default facet collection and are reported in meta.invalid.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.