latestOpenAPI 3.0.02026-08-1013895.5 KB

99d2ed0023e2

People Groups Across Countries (PGAC)

Search all people groups across countries based on provided filters. (JSON or XML)

Search through all the various people groups across the countries they reside in.

get/v1/people_groups_global.{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.

include_country_liststring

A boolean (represented as a string Y or N) that states whether you want to include a list of countries that they reside in. (Default: Y)

is_frontierstring

A boolean (represented as a string Y or N) that states whether you want people groups that as a whole are considered frontier people groups.

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.

languagesstring

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.

limitinteger

The maximum results to return.

number_of_countriesstring

A dashed seperated range specifying the minimum and maximum number of countries the people group resides in.(min-max) You can supply just the minimum to get people groups with that matching number of countries.

number_of_unreachedstring

A dashed seperated range specifying the minimum and maximum number of people groups in country (PGIC) that are considered unreached.(min-max) You can supply just the minimum to get people groups that match that number.

number_of_frontierstring

A dashed seperated range specifying the minimum and maximum number of people groups in country (PGIC) that are considered a frontier people group.(min-max) You can supply just the minimum to get people groups that match that number.

pageinteger

The page of results to display.

pc_christianstring

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

pc_evangelicalstring

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

people_id1string

A bar separated list of one or more Joshua Project affinity block codes to filter by. See https://joshuaproject.net/help/definitions#affinity-bloc.

people_id2string

A bar separated list of one or more Joshua Project people cluster codes to filter by. See https://joshuaproject.net/help/definitions#people-cluster.

people_id3string

A bar separated list of one or more ethnicity codes to filter by.

populationstring

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.

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
rop3string

A bar separated list of one or more Registry of People IDs to filter by.

sort_fieldstring

The field to sort by. You can sort by any field <a href='/v1/docs/column_descriptions/people_groups_global' 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>

unreachedstring

A boolean (represented as a string Y or N) that states whether you want people groups that are as a whole considered unreached.

Response

The details of the specified people group.

object required