Get detailed organisation data by UID

GET 
/organisations/by-uid/:uid

Available in plans: Swiss Registry · Swiss Registry Signatory · Swiss Registry Signatory Excerpt · Partner

Retrieves detailed information for a given organisation based on its unique identifier (UID).

Proposed Usage

• Since you need the exact UID of the queried organization, the suggestions endpoint can be used beforehand, to find the right organisation and its UID.
• We disclaim any legal liability for any damages or consequences that may result from the use of the data provided.

Usage Limits

• This endpoint is rate limited, please refer to the response headers for further details on limits and reset times.

Request

Responses

200

Organization details

Response Headers

RateLimit-Policy
The rate limit policy applied to this request
Example: 10;w=60
RateLimit-Limit
The rate limit for this endpoint
Example: 10
RateLimit-Remaining
The number of requests remaining in the current rate limit window
Example: 7
RateLimit-Reset
The amount of seconds before the rate limit window requests
Example: 39
RateLimit-Origin
Origin of the 429 rate limit (e.g. Jupi or when absent; other gateway like DMP)
Example: jupi

400

Invalid UID format. Expected format: CHE-123.456.789 or CHE123456789

Response Headers

RateLimit-Policy
The rate limit policy applied to this request
Example: 10;w=60
RateLimit-Limit
The rate limit for this endpoint
Example: 10
RateLimit-Remaining
The number of requests remaining in the current rate limit window
Example: 7
RateLimit-Reset
The amount of seconds before the rate limit window requests
Example: 39
RateLimit-Origin
Origin of the 429 rate limit (e.g. Jupi or when absent; other gateway like DMP)
Example: jupi

404

Entity not found

Response Headers

RateLimit-Policy
The rate limit policy applied to this request
Example: 10;w=60
RateLimit-Limit
The rate limit for this endpoint
Example: 10
RateLimit-Remaining
The number of requests remaining in the current rate limit window
Example: 7
RateLimit-Reset
The amount of seconds before the rate limit window requests
Example: 39
RateLimit-Origin
Origin of the 429 rate limit (e.g. Jupi or when absent; other gateway like DMP)
Example: jupi

429

The API returns the error message when the quota for the resource has been exhausted. The detail in the response must provide information about the service quota allocated and renewal interval. When this error is returned, the request should not be retried within the same quota interval.

Response Headers

RateLimit-Policy
The rate limit policy applied to this request
Example: 10;w=60
RateLimit-Limit
The rate limit for this endpoint
Example: 10
RateLimit-Remaining
The number of requests remaining in the current rate limit window
Example: 7
RateLimit-Reset
The amount of seconds before the rate limit window requests
Example: 39
RateLimit-Origin
Origin of the 429 rate limit (e.g. Jupi or when absent; other gateway like DMP)
Example: jupi

500

Internal server error

Response Headers

RateLimit-Policy
The rate limit policy applied to this request
Example: 10;w=60
RateLimit-Limit
The rate limit for this endpoint
Example: 10
RateLimit-Remaining
The number of requests remaining in the current rate limit window
Example: 7
RateLimit-Reset
The amount of seconds before the rate limit window requests
Example: 39
RateLimit-Origin
Origin of the 429 rate limit (e.g. Jupi or when absent; other gateway like DMP)
Example: jupi

502

Invalid response from UID service

Response Headers

RateLimit-Policy
The rate limit policy applied to this request
Example: 10;w=60
RateLimit-Limit
The rate limit for this endpoint
Example: 10
RateLimit-Remaining
The number of requests remaining in the current rate limit window
Example: 7
RateLimit-Reset
The amount of seconds before the rate limit window requests
Example: 39
RateLimit-Origin
Origin of the 429 rate limit (e.g. Jupi or when absent; other gateway like DMP)
Example: jupi