# Retrieve specific schema

This operation is used to retrieve individual schema definitions by his schema URI.

For example: 

> : The contents of schema returned are described in Section 7 of [RFC7643].


Endpoint: GET /scim/v2/Schemas/{id}
Version: latest
Security: BearerAuth

## Path parameters:

  - `id` (string, required)
    The specific schema ID.
    Example: "urn:ietf:params:scim:schemas:core:2.0:Group"

## Response 200 fields (application/json):

  - `id` (any, required)
    The unique URI of the schema.
When applicable, service providers must specify the URI, e.g., "urn:ietf:params:scim:schemas:core:2.0:User".
Unlike most other schemas, which use some sort of Globally Unique Identifier (GUID) for the "id", the schema "id" is a URI so that it can be registered and is portable between different service providers and clients.
    Example: "urn:ietf:params:scim:schemas:core:2.0:Group"

  - `name` (any)
    The schema's human-readable name.
When applicable, service providers must specify the name, e.g., "User" or "Group".
    Example: "Group"

  - `description` (any)
    The schema's human-readable description.
When applicable, service providers must specify the description.
    Example: "Group"

  - `attributes` (array)
    A complex type that defines service provider attributes and their qualities via the following set of sub-attributes:
    Example: [{"name":"displayName","type":"string","multiValued":false,"required":false,"caseExact":false,"mutability":"readWrite","returned":"default","uniqueness":"none"},{"name":"members","type":"complex","multiValued":true,"required":false,"mutability":"readWrite","returned":"default","subAttributes":[{"name":"value","type":"string","multiValued":false,"required":false,"caseExact":false,"mutability":"immutable","returned":"default","uniqueness":"none"},{"name":"$ref","type":"reference","referenceTypes":["User","Group"],"multiValued":false,"required":false,"caseExact":false,"mutability":"immutable","returned":"default","uniqueness":"none"},{"name":"type","type":"string","multiValued":false,"required":false,"caseExact":false,"canonicalValues":["User","Group"],"mutability":"immutable","returned":"default","uniqueness":"none"}]}]

  - `attributes.name` (any)
    The attribute's name.

  - `attributes.type` (string)
    The attribute's data type.  Valid values are "string", "boolean", "decimal", "integer", "dateTime", "reference", and "complex".
When an attribute is of type "complex", there SHOULD be a corresponding schema attribute "subAttributes" defined, listing the sub-attributes of the attribute.
    Enum: "string", "boolean", "decimal", "integer", "dateTime", "reference", "complex"

  - `attributes.subAttributes` (array)
    When an attribute is of type "complex", "subAttributes" defines a set of sub-attributes. "subAttributes" has the same schema sub-attributes as "attributes".

  - `attributes.multiValued` (boolean)
    A Boolean value indicating the attribute's plurality.

  - `attributes.description` (string)
    The attribute's human-readable description.
When applicable, service providers must specify the description.

  - `attributes.required` (boolean)
    A Boolean value that specifies whether or not the attribute is required.

  - `attributes.canonicalValues` (string)
    A collection of suggested canonical values that may be used (e.g., "work" and "home").  In some cases, service providers may choose to ignore unsupported values.

  - `attributes.caseExact` (boolean)
    A Boolean value that specifies whether or not a string attribute is case sensitive.
The server will use case sensitivity when evaluating filters.  For attributes that are case exact, the server will preserve case for any value submitted.
If the attribute is case insensitive, the server may alter case for a submitted value.
Case sensitivity also impacts how attribute values may be compared against filter values (see [Section 3.4.2.2 of [RFC7644]](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2.2)).

  - `attributes.mutability` (string)
    A single keyword indicating the circumstances under which the value of the attribute can be (re)defined.
    Enum: "readOnly", "readWrite", "immutable", "writeOnly"

  - `attributes.returned` (string)
    A single keyword that indicates when an attribute and associated values are returned in response to a GET request or in response to a PUT, POST, or PATCH request.
    Enum: "always", "never", "default", "request"

  - `attributes.uniqueness` (string)
    A single keyword value that specifies how the service provider enforces uniqueness of attribute values.
A server may reject an invalid value based on uniqueness by returning HTTP response code 400 (Bad Request).
A client may enforce uniqueness on the client side to a greater degree than the service provider enforces.
For example, a client could make a value unique while the server has uniqueness of "none".
    Enum: "none", "server", "global"

  - `attributes.referenceTypes` (string)
    A multi-valued array of JSON strings that indicate the SCIM resource types that may be referenced.
    Enum: "User", "Group", "external", "uri"

  - `resourceType` (string)
    The name of the resource type of the resource.

  - `created` (string)
    The "DateTime" that the resource was added to the service provider.

  - `lastModified` (string)
    The most recent DateTime that the details of this resource were updated at the service provider.

  - `location` (string)
    The URI of the resource being returned.

  - `version` (string)
    The version of the resource being returned.

## Response 404 fields (application/json):

  - `status` (string)

  - `detail` (string)