Developers / API Documentation / Resources

Organizations

GET organizations/:organization_id

Returns information about the specified organization.

Request Parameters

Parameter Name Type Description
organization_id int (In URL) The ID of the organization about which information will be retrieved.

Response Data

Field Name Type Description
organization_id int The ID of the organization about which information was retrieved.
name string The full name of the organization.
location string The full location of the organization in English. (e.g. San Francisco, CA or Paris, France)
address string (If available) The address of the organization.
city string (If available) City of the organization.
state_province string (If available) The standard abbreviation of the state or province of the organization.
postal_code string (If available) The postal code of the organization.
country_name string Full English name of the country of the organization.
country_code string The two-letter code of the country of the organization.
website string (If available) The URL to the organization's website.
mission string (If available) The mission statement provided by the organization.
organization_url string The URL to the organization's profile on Change.org

Example:

GET https://api.change.org/v1/organizations/298374
=>  {
"organization_id": 73899,
"name": "United Federation of Planets",
"location": "Paris, France",
"city": "Paris",
"country_name": "France",
"country_code": "FR",
"website": "http://en.memory-alpha.org/wiki/United_Federation_of_Planets",
"mission": "To be peaceful and do other things.",
"organization_url": "http://www.change.org/groups/the_federation"
}

GET organizations/:organization_id/petitions

Returns the array of petitions that were created by the specified organization. For more information about the petition information returned, see Petitions.

Request Parameters

Parameter Name Type Description
organization_id int (In URL) The ID of the organizations whose petitions have been returned.
fields string of comma-separated field names (Optional) The fields of the petition data objects that will be returned for each petition in the response. The parameter should include the field names (described in GET petitions/:petition_id), separated by commas. Omitting this parameter will return all available fields.

Example: "title,url,signature_count"
page_size int (Optional) The maximum number of petition data objects to return per request, no more than 500. If omitted, returns the maximum number of petitions.
page int (Optional) The page offset by page_size petitions. If omitted, returns the first page by default.
sort string (Optional) The order by which petitions will be returned. Accepted values are the number of signatures, signatures_asc or signatures_desc, or the date and time the petition was created, time_asc or time_desc. If omitted, returns petitions in the ascending order in which they were created.

Response Data

Field Name Type Description
organization_id int The ID of the organization whose petitions have been returned.
page int The current page number. Defaults to 1.
prev_page_endpoint string The API endpoint that can be called to retrieve the previous page of petitions. null if there is no previous page.
next_page_endpoint string The API endpoint that can be called to retrieve the next page of petitions. null if there is no next page.
page int The current page number.
total_pages int The total number of pages of petitions (of size specified by page_size)
petitions array of petitions created by the specified organization See Petitions for more information about petition data objects.

GET organizations/get_id

Returns the unique Change.org ID for the organization specified by organization_url, which is the URL to the organization's profile on Change.org. Before performing requests on an organization resource, this ID is required because organization profile URLs can change.

Request Parameters

Parameter Name Type Description
organization_url string The URL to the organization's Change.org profile.

Response Data

The ID of the requested organization.

Field Name Type Description
organization_id int The unique Change.org ID of the organization.

Example:

GET https://api.change.org/v1/organizations/get_id?organization_url=http%3A%2F%2Fwww.change.org%2Fgroups%2Fthe_federation
=> { "organization_id": 73899 }

Note: A public API key is a required parameter on all requests, and a timestamp, endpoint, and request signature are required on certain requests. For readability, these parameters have been omitted from the tables and examples above.