Viviot.Api

<back to all web services

GetOrganization

Requires Authentication
The following routes are available for this service:
GET/organizationGets an organization assigned to a business user with all corresponding sub-organizations (optional).
GetOrganization Parameters:
NameParameterData TypeRequiredDescription
OrganizationIdquerystringNoOrganization Id for which to get list of sub-organizations (optioanl).
LoadSubOrganizationsquerybooleanNoInclude sub-organizations in organization response data.
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
VersionformintegerNoApi version
OrganizationResponse Parameters:
NameParameterData TypeRequiredDescription
DataformOrganizationBasicViewNo
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo
OrganizationBasicView Parameters:
NameParameterData TypeRequiredDescription
IdformGuidNo
NameformstringNo
TypeformOrganizationTypeNo
SubOrganizationsformList<OrganizationBasicView>No
OrganizationType Enum:
NameValue
Unknown0
Admin10
Tenant20
Location30

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /organization HTTP/1.1 
Host: api.4spaces.io 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	data: 
	{
		id: 00000000000000000000000000000000,
		name: String,
		type: 0,
		organizations: 
		[
			{
				id: 00000000000000000000000000000000,
				name: String,
				type: 0,
				organizations: 
				[
					{
						id: 00000000000000000000000000000000,
						name: String,
						type: 0,
						organizations: 
						[
							{
								
							}
						]
					}
				]
			}
		]
	},
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	}
}