# Read an organisation's SAML service provider metadata

> Page: https://docs.plotwork.dev/api/get-auth-sso-saml-org-metadata. Index of every page: https://docs.plotwork.dev/llms.txt

Our entity id, our assertion consumer service on the POST binding, the email name identifier and signed assertions wanted, for one organisation id.

`GET /auth/sso/saml/{org}/metadata`

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | Read an organisation's SAML service provider metadata. |
| What does it take? | `org` in the path. |
| What does it return? | Status 200 with no body. |
| What can go wrong? | `400` not an organisation id; `429` too many requests. Every failure uses the one error envelope. |

## What it does

Our entity id, our assertion consumer service on the POST binding, the email name identifier and signed assertions wanted, for one organisation id. The same answer for every id, so it reveals nothing.

## Path parameters

| Field | Type | Required | Description |
|---|---|---|---|
| `org` | `string` | yes |  |

## Responses

| Status | Meaning | Body |
|---|---|---|
| 200 | The metadata XML. | none |
| 400 | Not an organisation id. | [`ErrorResponse`](https://docs.plotwork.dev/api/schemas.md#errorresponse) |
| 429 | Too many requests. | [`ErrorResponse`](https://docs.plotwork.dev/api/schemas.md#errorresponse) |

## See also

| Doc | Why |
|---|---|
| [API reference](https://docs.plotwork.dev/api/reference.md) | Every endpoint, and the error envelope |
| [Schemas](https://docs.plotwork.dev/api/schemas.md) | Every request and response type |
| [Tool reference](https://docs.plotwork.dev/mcp/tools.md) | The operations as callable tools |