Get a list of organizations
get
/api/v1/organizations
{basePath}/organizations?offset=1&limit=2
The API returns a list of organizations with which the integrator is privileged to interact.Request
Supported Media Types
- application/json
Query Parameters
-
limit: integer
Minimum Value:
0The limit used for the current page.The maximum number of items to return in this request. -
offset: integer
Minimum Value:
0The offset of the start of the current page in the collection. If offset is not included in the request then all objects returned.
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : organizations
Type:
objectRead Only:
trueA collection of Organizations
Show Source
-
count:
integer
Total number of items in the collection for all pages.
-
limit:
integer
The limit used for the current page.
-
offset:
integer
The offset of the start of the current page in the collection.
-
organization(required):
array organization
Array of Organization JSON objects. If there are no organizations configured, this array will be empty.
Nested Schema : organization
Type:
arrayArray of Organization JSON objects. If there are no organizations configured, this array will be empty.
Show Source
-
Array of:
object Organization
Title:
OrganizationAn organization is the overarching organizational entity for a specific customer in Oracle Food and Beverage Cloud Products. An organization includes one or more locations.
Nested Schema : Organization
Type:
objectTitle:
OrganizationAn organization is the overarching organizational entity for a specific customer in Oracle Food and Beverage Cloud Products. An organization includes one or more locations.
Show Source
-
name(required):
string
Full name of the organization.Example:
The Food Organization Inc -
orgShortName(required):
string
Minimum Length:
1Maximum Length:10Pattern:[A-Za-z0-9]The organization identifier.Example:tfoinc
Example:
{
"orgShortName":"tfoinc",
"name":"The Food Organization Inc"
}400 Response
400 Bad Request
Root Schema : OrganizationApiProblemDetails
Type:
objectProblem details is used as standard model for reporting details when HTTP error status code is returned. This definition is defined by [RFC7807](https://tools.ietf.org/html/rfc7807).
Show Source
-
details:
string
A human-readable explanation specific to this occurrence of the problem.
-
instance:
string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
-
title:
string
A short, human-readable summary of the problem type.
-
type:
string
A URI reference [RFC3986](https://tools.ietf.org/html/rfc3986) that identifies the problem type. When this member is not present, its value is assumed to be "about:blank".
Example:
{
"type":"error:validation",
"title":"Required value not specified.",
"details":"The OrgShortName value is required.",
"instance":"required_value_missing"
}401 Response
401 Unauthorized
403 Response
403 Forbidden
404 Response
404 Requested resource not found
Examples
Example Request Body
Not applicable for this endpoint.
Example Response Body
The following example shows the contents of the response body in JSON format:
{
"limit": 0,
"offset": 0,
"count": 0,
"items": [
{
"orgShortName": "tfoinc",
"name": "The Food Organization Inc"
}
]
}