Search all people groups with diverse filters (JSON or XML)
Find all people groups that match your filter criteria.
Request
- Base URLhttps://api.joshuaproject.net (the document declares no server; this is the origin it was published from)
- Authnone declared
Path parameters
The format of the response, either 'json' or 'xml'.
Query parameters
Your Joshua Project API key.
A bar separated list of one or more BibleStatus levels. Only accepts the following codes: 0, 1, 2, 3, 4, 5. The statuses are:
- 0 = Unspecified
- 1 = Translation needed
- 2 = Translation started
- 3 = Portions
- 4 = New Testament
- 5 = Complete Bible
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
A bar separated list of one or more countries to filter by. Use the 2 letter FIPS 10-4 code. View all Country Codes.
A boolean (represented as a string Y or N) that states whether you want people groups that have access to an audio recorded Bible.
A boolean (represented as a string Y or N) that states whether you want people groups that have access to the Jesus Film.
A boolean (represented as a string Y or N) that states whether you want to include the people group's profile text. (HowReach, Obstacles, PrayForChurch, PrayForPG, Summary) By setting to 'N', it could speed up the request.
A boolean (represented as a string Y or N) that states whether you want to include the people group's resources. By setting to 'N', it could speed up the request.
A boolean (represented as a string Y or N) that states whether you want people groups that are indigenous.
A boolean (represented as a string Y or N) that states whether you want people groups that are frontier people groups.
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.
A bar separated list of one or more language codes to filter by. Use the 3 letter ISO code. See the code list for the codes.
A boolean (represented as a string Y or N) that states whether you want people groups that are least reached.
The maximum results to return.
A boolean (represented as a string Y or N) that states whether you want people groups that are nomadic.
The page of results to display.
A dashed seperated range specifying the minimum and maximum percentage of Adherents.(min-max) You can supply just the minimum to get people groups matching that percentage.
A dashed seperated range specifying the minimum and maximum percentage of Buddhist.(min-max) You can supply just the minimum to get people groups matching that percentage. Decimals accepted!
A dashed seperated range specifying the minimum and maximum percentage of Ethnic Religions.(min-max) You can supply just the minimum to get people groups matching that percentage. Decimals accepted!
A dashed seperated range specifying the minimum and maximum percentage of Evangelicals.(min-max) You can supply just the minimum to get people groups matching that percentage. Decimals accepted!
A dashed seperated range specifying the minimum and maximum percentage of Hindus.(min-max) You can supply just the minimum to get people groups matching that percentage. Decimals accepted!
A dashed seperated range specifying the minimum and maximum percentage of Islam.(min-max) You can supply just the minimum to get people groups matching that percentage. Decimals accepted!
A dashed seperated range specifying the minimum and maximum percentage of Non-Religious.(min-max) You can supply just the minimum to get people groups matching that percentage. Decimals accepted!
A dashed seperated range specifying the minimum and maximum percentage of Other Religions.(min-max) You can supply just the minimum to get people groups matching that percentage. Decimals accepted!
A dashed seperated range specifying the minimum and maximum percentage of Unkown Religions.(min-max) You can supply just the minimum to get people groups matching that percentage. Decimals accepted!
A bar separated list of one or more Joshua Project affinity block codes to filter by. See https://joshuaproject.net/help/definitions#affinity-bloc.
A bar separated list of one or more Joshua Project people cluster codes to filter by. See https://joshuaproject.net/help/definitions#people-cluster.
A bar separated list of one or more Joshua Project people group codes to filter by.
A dashed seperated range specifying the minimum and maximum population.(min-max) You can supply just the minimum to get people groups with a population matching that number.
A dashed seperated range specifying the minimum and maximum population for the people group in all countries (PGAC).(min-max) You can supply just the minimum to get people groups with a population matching that number.
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
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
A bar separated list of one or more Registry of People affinity block codes to filter by.
A bar separated list of one or more Registry of People people cluster codes to filter by.
A bar separated list of one or more Registry of People people group codes to filter by.
The field to sort by. You can sort by any field <a href='/v1/docs/column_descriptions/people_groups' target='_blank'>listed here</a> except: HowReach, LRWebProfile, LRofTheDayDay, LRofTheDayMonth, LRofTheDaySet, MapCCVersionText, MapCCVersionURL, MapCopyright, MapCreditURL, MapCredits, Obstacles, PeopleGroupMapExpandedURL, PeopleGroupMapURL, PeopleGroupPhotoURL, PhotoCCVersionText, PhotoCCVersionURL, PhotoCopyright, PhotoCreativeCommons, PhotoCredits, PhotoCreditURL, PhotoPermission, PrayForChurch, PrayForPG, Summary. <strong>You must also provide a sort_direction.</strong>
The direction to sort by. (ASC or DESC) <strong>You must also provide a sort_field.</strong>
A boolean (represented as a string Y or N) that states whether you want people groups in the 1040 Window.
Response
The list of people groups based off your criteria.
Changes
No recorded changes to this operation across all 1 revision of this API.