latestOpenAPI 3.0.02026-08-1013895.5 KB

99d2ed0023e2

Countries

Find all countries that match your filter criteria.

Retrieve a list of Countries that match your filter settings.

get/v1/countries.{format}

Path parameters

format'json' | 'xml' required

The format of the response, either 'json' or 'xml'.

Query parameters

api_keystring required

Your Joshua Project API key.

bible_completestring

A dashed seperated range specifying the minimum and maximum total number of Primary Languages (CntPrimaryLanguages) in the country that have a Bible Status of <strong>Complete Bible</strong>.(min-max) You can supply just the minimum to get a total matching that number.

bible_new_testamentstring

A dashed seperated range specifying the minimum and maximum total number of Primary Languages (CntPrimaryLanguages) in the country that have a Bible Status of <strong>New Testament</strong>.(min-max) You can supply just the minimum to get a total matching that number.

bible_portionsstring

A dashed seperated range specifying the minimum and maximum total number of Primary Languages (CntPrimaryLanguages) in the country that have a Bible Status of <strong>Portions</strong>.(min-max) You can supply just the minimum to get a total matching that number.

continentsstring

A bar separated list of one or more continents to filter by.Use the following codes:

  • AFR = Africa
  • ASI = Asia
  • AUS = Australia
  • EUR = Europe
  • NAR = North America
  • SOP = Oceania (South Pacific)
  • LAM = South America
cnt_primary_languagesstring

A dashed seperated range specifying the minimum and maximum total number of primary languages.(min-max) You can supply just the minimum to get countries with a total number of primary languages matching that number.

idsstring

A bar separated list of one or more FIPS 10-4 Letter Country Codes to filter by. See https://goo.gl/yYWY4J.

jpscalestring

A bar separated list of one or more JPScale codes to filter by. Only accepts the following codes: 1, 2, 3, 4, 5. For more information check out https://joshuaproject.net/global/progress.

limitinteger

The maximum results to return.

pageinteger

The page of results to display

pc_buddhiststring

A dashed seperated range specifying the minimum and maximum percentage of Buddhist.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

pc_christianitystring

A dashed seperated range specifying the minimum and maximum percentage of Christians.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

pc_ethnic_religionstring

A dashed seperated range specifying the minimum and maximum percentage of Ethnic Religions.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

pc_evangelicalstring

A dashed seperated range specifying the minimum and maximum percentage of Evangelicals.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

pc_hindustring

A dashed seperated range specifying the minimum and maximum percentage of Hindus.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

pc_islamstring

A dashed seperated range specifying the minimum and maximum percentage of Islam.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

pc_non_religiousstring

A dashed seperated range specifying the minimum and maximum percentage of Non-Religious.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

pc_other_religionstring

A dashed seperated range specifying the minimum and maximum percentage of Other Religions.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

pc_unknownstring

A dashed seperated range specifying the minimum and maximum percentage of Unkown Religions.(min-max) You can supply just the minimum to get Countries matching that percentage. Decimals accepted!

populationstring

A dashed seperated range specifying the minimum and maximum population.(min-max) You can supply just the minimum to get Countries matching that number.

pop_in_frontierstring

A dashed seperated range specifying the minimum and maximum population living among frontier people groups.(min-max) You can supply just the minimum to get Countries matching that number.

pop_in_unreachedstring

A dashed seperated range specifying the minimum and maximum population living among the unreached.(min-max) You can supply just the minimum to get Countries matching that number.

primary_languagesstring

A bar seperated list of ISO 3 Letter Codes. For more information check out this code list.

primary_religionsstring

A bar separated list of one or more primary religions to filter by. Use the following numbers:

  • 1 = Christianity
  • 2 = Buddhism
  • 4 = Ethnic Religions
  • 5 = Hinduism
  • 6 = Islam
  • 7 = Non-Religious
  • 8 = Other/Small
  • 9 = Unknown
regionsstring

A bar separated list of one or more regions to filter by. Use the following numbers:

  • 1 = South Pacific
  • 2 = Southeast Asia
  • 3 = Northeast Asia
  • 4 = South Asia
  • 5 = Central Asia
  • 6 = Middle East and North Africa
  • 7 = East and Southern Africa
  • 8 = West and Central Africa
  • 9 = Eastern Europe and Eurasia
  • 10 = Western Europe
  • 11 = Central and South America
  • 12 = North America and Caribbean
sort_fieldstring

The field to sort by. You can sort by any field <a href='/v1/docs/column_descriptions/countries' target='_blank'>listed here</a>. <strong>You must also provide a sort_direction.</strong>

sort_directionstring

The direction to sort by. (ASC or DESC) <strong>You must also provide a sort_field.</strong>

translation_neededstring

A dashed seperated range specifying the minimum and maximum total number of Primary Languages (CntPrimaryLanguages) in the country that have a Bible Status of Translation Needed.(min-max) You can supply just the minimum to get a total matching that number.

translation_startedstring

A dashed seperated range specifying the minimum and maximum total number of Primary Languages (CntPrimaryLanguages) in the country that have a Bible Status of Translation Started.(min-max) You can supply just the minimum to get a total matching that number.

translation_unspecifiedstring

A dashed seperated range specifying the minimum and maximum total number of Primary Languages (CntPrimaryLanguages) in the country that have a Bible Status of Unspecified.(min-max) You can supply just the minimum to get a total matching that number.

window1040string

A boolean (represented as a string Y or N) that states whether you want countries in the 1040 Window.

Response

The results of your filtered countries.

object required