Get detailed organisation data by its exact legal name

GET 
/organisations/by-name/:name

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

Retrieves detailed information for a given organisation based on its legal name.

Proposed Usage

• Since you need the exact legal name of the queried organization, the suggestions endpoint can be used beforehand, to find the right organisation and its legal name.
• 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

Organisation name cannot be empty, too short (minimum 2 characters), or contain only whitespace

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

No organisation found with this nam

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