Show more

Use to navigate results, ENTER to select one, ESC to close

Type in any word to easily find the endpoint, property or group of operations you are looking for.

API changelog
Download source
  • JSON OpenAPI specification
  • YAML OpenAPI specification
Connect logo

Topics

  • Introduction
  • Authentication

Endpoints

  • Users
    • All admin users for the given organisation GET
    • Create an organisation admin user POST
    • Gets details of an organisation admin user by their email address GET
    • Reactivate or deactivate an organisation admin user by their email address PUT
    • All users for the given authorisation domain GET
    • Create an authorisation domain user POST
    • Authorisation Domain user details GET
    • All data administrators GET
    • Create a data administrator POST
    • Toggle active status of users data administrator role PUT
    • All super users GET
    • Details of the user GET
    • TnC history of the user GET
  • Organisations
    • Get all organisations that the logged in user is authorised to retrieve from trusted services GET
    • Post a new organisation in the directory. POST
    • Get the given organisations details GET
    • Amend the given organisations details PUT
    • Delete an organisation by changing its status to "Withdrawn" DELETE
    • Get all Authorisation Servers for the given organisation GET
    • Create an Authorisation Server for the given organisation POST
    • Get an authorisation server by Id GET
    • Update an authorisation server PUT
    • Delete an Authorisation Server DELETE
    • Get all Api Resources for the given Authorisation Server GET
    • Create an Api Resource for the given organisation and Authorisation Server POST
    • Get an authorisation server API resource by Id GET
    • Update an Api Resource for the given organisation and Authorisation Server PUT
    • Delete an authorisation server API resource by Id DELETE
    • Get all Api Discovery Endpoints for the given Authorisation Server and Api Version GET
    • Create an Api Discovery Endpoint for the given organisation and Authorisation Server and Api Version POST
    • Get an authorisation server API discovery endpoint by Id GET
    • Update an Api Discovery Endpoint for the given organisation, Authorisation Server and Api Version PUT
    • Delete an Api Discovery Endpoint for the given organisation, Authorisation Server and Api Version DELETE
    • Get an authorisation server API resource metadata GET
    • Edit an api resource metadata entry for the given api resource PUT
    • Get the authority claims for the given server GET
    • Post an authority claim for a server POST
    • Get an server authority claim by Id GET
    • Update a server authority claim for the given Id PUT
    • Delete a server authority claim DELETE
    • Get all certifications for given authorisation server GET
    • Post a certification for the given authorisation server POST
    • Get a certification by Id GET
    • Update the given certification PUT
    • Remove a certification with the given certification Id DELETE
    • Get an authorisation server API resource by Id and returns the latest family status GET
    • Retrieves all instances of sso configuration for a given authorisation server. GET
    • Creates an instance of sso configuration for a given authorisation server. POST
    • Retrieves a specific instance of sso configuration for a given authorisation server. GET
    • Updates a specific instance of sso configuration for a given authorisation server. PUT
    • Deletes a specific instance of sso configuration for a given authorisation server. DELETE
    • Retrieves all historical configuration of a given sso configuration for a given authorisation server. GET
    • Creates a new version of sso configuration for a given authorisation server. POST
    • Retrieves a specific version of sso configuration for a given sso configured authorisation server. GET
    • Updates a specific instance of sso configuration for a given authorisation server. PUT
    • Deletes a specific version of configuration for a given sso-enabled authorisation server. DELETE
    • Configures a given organisation as an authority POST
    • Retrieves the authority configuration for a given organisation GET
    • Updates a given organisations authority configuration PUT
    • Get the authority claims for the given organisation GET
    • Post an authority claim POST
    • Get an authority claim by Id GET
    • Update an organisation authority domain role claim for the given Id PUT
    • Delete an authority claim DELETE
    • Get an authority claims authorisations GET
    • Post an authority claims authorisations POST
    • Get a claim authorisation GET
    • Remove an authorisation from authority claims DELETE
    • Get the authority domain claims for the given organisation GET
    • Post an authority domain claim POST
    • Get an authority domain claim by Id GET
    • Update an authority domain claim by Id PUT
    • Deactivate an authority domain claim by Id DELETE
    • Get the certificates for the given organisation GET
    • Retrieve a certificate with the given CertificateOrKeyId GET
    • Revoke or remove a certificate with the given CertificateOrKeyId providing a revoke reason PUT
    • Get the certificates of the given OrganisationCertificateType for the given organisation GET
    • Store or create a new certificate of the given OrganisationCertificateType for the given organisation POST
    • Create and execute a Conformance Suite test plan for the given organisation POST
    • Get the contacts for the given organisation GET
    • Post a contact for the given organisation POST
    • Get a contact by Id GET
    • Update the contacts for the given organisation PUT
    • Remove a contact in an organisation with the given contact id DELETE
    • This API initiates ESS signing process by an org admin POST
    • This API marks the current envelope as reissued and allows a new one to be started POST
    • Get all software statements for the given organisation GET
    • Create a software statement POST
    • Get a specific software statement GET
    • Update a software statement by Id. PUT
    • Delete or revoke a software statement with the given softwarestatementID DELETE
    • Get a Software Statement Assertion for the given SoftwareStatementID. GET
    • Get the authority claims for the given software statement GET
    • Post an authority claim for a software statement POST
    • Get an authority claim by Id GET
    • Update an authority claim for the given Id PUT
    • Get certificates for the given software statement GET
    • Add a key or create a new certificate for the given software statement POST
    • Get the certificate of the given type and ID for the given software statement GET
    • Update a software statement certificate with the given CertificateOrKeyId e.g. revoke reason PUT
    • Get all certifications for given Software Statement. GET
    • Post a certification for the given Software Statement POST
    • Get a certification by Id GET
    • Update the given certification PUT
    • Remove a certification with the given certification Id DELETE
    • Get all metadata associated with a software statement GET
    • Unlock a software statement. PUT
    • Get all TnC data of the given organisation GET
  • Reference Data
    • Reference data of all authorisation domain roles GET
    • Create an authorisation domain role POST
    • Get an authorisation domain role by name GET
    • Update an authorisation domain role by name PUT
    • Deactivate an authorisation domain role by Name DELETE
    • Get metadata associated with an authorisation domain role GET
    • Create a metadata record associated with an authorisation domain role POST
    • Get metadata associated with an authorisation domain role GET
    • Change the status of a metadata object that is associated with an authorisation domain role PUT
    • Delete a metadata object that is associated with an authorisation domain role DELETE
    • Reference data of all authorisation domains GET
    • Create an authorisation domain POST
    • Get an authorisation domain by Name GET
    • Update an authorisation domain by Name PUT
    • Reference data of all authorisation domain roles GET
    • Create an authorisation domain role POST
    • Get an authorisation domain role by name GET
    • Update an authorisation domain role by name PUT
    • Deactivate an authorisation domain role by Name DELETE
    • Get metadata associated with an authorisation domain role GET
    • Create a metadata record associated with an authorisation domain role POST
    • Get metadata associated with an authorisation domain role GET
    • Change the status of a metadata object that is associated with an authorisation domain role PUT
    • Delete a metadata object that is associated with an authorisation domain role DELETE
    • Reference Data of all authorities GET
    • Get a reference authority by Id GET
    • Update a reference authority by Id PUT
    • Reference data of all authority authorisation domain mappings GET
    • Map an authorisation domain to an authority POST
    • Get an authority authorisation domain by Id GET
    • Activate an authority authorisation domain mapping by Id PUT
    • Deactivate an authority authorisation domain by Id DELETE
    • Get certification types GET
    • Set certification types POST
    • Get a specific certification type by ID GET
    • Update certification types PUT
    • Delete a certification type DELETE
    • Get certification type variants GET
    • Set certification type variant POST
    • Get certification type variant by ID GET
    • Update certification type variant by ID PUT
    • Delete a certification type variant DELETE
    • Returns all contact types configured at a reference data level GET
    • Create a new contact type POST
    • Returns a specific contact type configured at a reference data level GET
    • Updates an existing contact type PUT
    • Delete an existing contact type DELETE
    • Get all federations GET
    • Create a new federation POST
    • Get a federation by id GET
    • Update a federation PUT
    • Delete a federation DELETE
    • Get the metadata policy for a federation GET
    • Create a new metadata policy POST
    • Get a metadata policy GET
    • Update a metadata policy PUT
    • Delete a metadata policy DELETE
    • Returns all flags configured at a reference data level GET
    • Create a new flag POST
    • Returns a specific flag configured at a reference data level GET
    • Updates an existing flag PUT
    • Delete an existing flag DELETE
    • All terms and conditions GET
    • Create TnC POST
    • Get details for a TnC document GET
    • Update the content of a TnC document PUT
    • Deactivate a TnC document DELETE
    • Reference Data of all authorisation domain systems GET
    • Create Reference Data for a new authorisation domain system POST
    • Get specific record for authorisation domain system GET
    • Update Reference Data for a new authorisation domain system PUT
    • Remove Reference Data for a new authorisation domain system DELETE
    • Reference Data of all authorisation domain user types GET
    • Create Reference Data for a new authorisation domain user type POST
    • Get specific record for authorisation domain user type GET
    • Update Reference Data for a new authorisation domain user type PUT
    • Remove Reference Data for a new authorisation domain user type DELETE
  • Software Statements
    • Get all registered clients GET
    • Refresh/rebuild the registered clients data POST
    • Get details for one client GET
  • Audit History
    • Fetches audit history based on query parameters GET
  • Public
    • Update an authorisation domain user record by the unique identifier PUT
  • Global Search
    • Get the top 10 results based on a partial/full match of identifier GET
Powered by Bump.sh
API changelog
Download source
  • JSON OpenAPI specification
  • YAML OpenAPI specification
Connect logo

Get the top 10 results based on a partial/full match of identifier

Ask AI
  • Open in ChatGPT
  • Open in Claude

  • View as Markdown
  • Copy as Markdown
GET /search
O auth

Headers

  • x-fapi-auth-date string

    The time when the PSU last logged in with the TPP. All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: Sun, 10 Sep 2017 19:43:31 UTC

    Format should match the following pattern: ^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$.

  • x-fapi-customer-ip-address string

    The PSU's IP address if the PSU is currently logged in with the TPP.

  • x-fapi-interaction-id string

    An RFC4122 UID used as a correlation id.

  • x-customer-user-agent string

    Indicates the user-agent that the PSU is using.

Query parameters

  • identifier string

    The string to search for

    Maximum length is 255. Format should match the following pattern: ^[^<>]*$.

  • resourceTypes array[string]

    Comma-separated list of resource types to filter by

    Values are organisation, softwareStatement, authorisationServer, or certificate.

  • status array[string]

    The status of the resource

    Values are Active, Inactive, Suspended, Withdrawn, or Pending. Default value is Active.

Responses

  • 200 application/json

    Global Search response

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

    Hide response attribute Show response attribute object
    • results array[object]
      Hide results attributes Show results attributes object
      • identifier string Required
      • legalEntityName string | null
      • name string Required
      • organisationId string | null
      • resourceType string Required

        Values are organisation, softwareStatement, authorisationServer, or certificate.

      • softwareStatementId string

        Unique Software Statement Id

        Maximum length is 40. Format should match the following pattern: ^[^<>]*$.

      • status string Required

        Status of the resource

        Values are Active, Inactive, Suspended, Withdrawn, or Pending. Default value is Active.

  • 400 application/json

    Bad Request

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

    Hide response attribute Show response attribute object
    • errors array[string]

      Validation Error messages

  • 401

    Unauthorized

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 403

    Forbidden

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 404 application/json

    Not found

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

    Hide response attribute Show response attribute object
    • errors array[string]

      Validation Error messages

  • 406

    Not Acceptable

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 429

    Too many requests, maximum capacity reached. Requests are now throttled.

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 500

    Internal Server Error

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 502

    Bad Gateway

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 504

    Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

GET /search
curl \
 --request GET 'https://matls-api.sandbox.raidiam.io/search' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "x-fapi-auth-date: string" \
 --header "x-fapi-customer-ip-address: string" \
 --header "x-fapi-interaction-id: string" \
 --header "x-customer-user-agent: string"
Response examples (200)
# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "results": [
    {
      "identifier": "string",
      "legalEntityName": "string",
      "name": "string",
      "organisationId": "string",
      "resourceType": "organisation",
      "softwareStatementId": "string",
      "status": "Active"
    }
  ]
}
Response examples (400)
# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "errors": [
    "string"
  ]
}
Response examples (404)
# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "errors": [
    "string"
  ]
}