99d2ed0023e2
Search all people groups with diverse filters (JSON or XML)
Find all people groups that match your filter criteria.
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.