Uber Developers

Get Organization

GEThttps://api.uber.com/v1/organizations/{organization_id}

Privileged and Confidential This endpoint design has been confidentially shared with you. It is still under development and is subject to change without notice. Please do not share this document or API endpoint details with anyone who is not authorized to have access. For more information read about scopes.

¶ Use Case

The Get Organization endpoint allows you to get information about a particular organization.

¶ Authorization

The Get Organization endpoint requires an access_token using the client credentials (for 1P use-case) grant to business.organizations scope.

If an application follows third party authentication, the get organization endpoint requires the client to get authorized using the authorization endpoint

¶ Path Parameters

Name	Type	Optional	Description
`organization_id`	string	No	Identifier for your organization.

¶ Response Fields

Name	Type	Description
`organization`	object	An object containing the organization information
`organization.uuid`	string	Unique identifier of the organization.
`organization.name`	string	Name of the organization.
`organization.home_country_iso`	string	Home country of the organization.
`organization.status`	string	Status of the organization. The values can be ACTIVE or INACTIVE.
`organization.billing_mode`	string	Billing mode for an organization. The values can be CENTRALIZED or DECENTRALIZED.

¶ Example Request

curl -X GET "https://api.uber.com/v1/organizations/<organization_id>"
-H 'Content-Type: application/json'
-H "Authorization: Bearer <TOKEN>"

¶ Example Response

Status-Code: 200 OK

{
  "organization": {
    "uuid": "448e68b1-b96c-464e-870d-096a44c80323",
    "name": "spj test org",
    "home_country_iso": "US",
    "status": "INACTIVE",
    "billing_mode": "DECENTRALIZED"
  }
}

¶ Error Responses

HTTP Status	Code	Description
400	`BAD_REQUEST`	request specific message
401	`NOT_AUTHORIZED`	Caller not authorized to make this request
500	`INTERNAL_SERVER_ERROR`	We have experienced a problem