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.

Responses

• 201 application/json

  Full details of the organisation including warnings on a create or update operation

  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 attributes Show response attributes object

  • OperationWarnings array[string]

    A warning code that describes a warning condition that occurred during the last operation

    Values are IMAGE_UPLOAD_FAILURE_PLACEHOLDER_USED, IMAGE_VALIDATION_FAILURE_BAD_DATA_ENCODING_PLACEHOLDER_USED, IMAGE_VALIDATION_FAILURE_UNSUPPORTED_IMAGE_FORMAT_PLACEHOLDER_USED, IMAGE_VALIDATION_CONTENT_FAILURE_PLACEHOLDER_USED, IMAGE_VALIDATION_DIMENSIONS_FAILURE_PLACEHOLDER_USED, IMAGE_VALIDATION_MAX_SIZE_FAILURE_PLACEHOLDER_USED, IMAGE_VALIDATION_FAILURE_SVG_VALIDATION_PLACEHOLDER_USED, IMAGE_VALIDATION_CONTENT_WARNING_SUPERUSER_OVERRIDE, or IMAGE_VALIDATION_DIMENSIONS_WARNING_SUPERUSER_OVERRIDE.

  • AddressLine1 string

    Address line 1

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

  • AddressLine2 string

    Address line 2

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

  • City string

    City

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

  • CompanyRegister string

    Legal company register for the country, i.e. Companies House

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

  • Country string

    Country

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

  • CountryOfRegistration string

    Country of registration for the org

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

  • CreatedOn string

    JSONDatetime of organisation creation.

    Maximum length is 30.

  • EnforceIdpUserManagement boolean

    When true, prevents the creation of users directly on the organisation and mandates all users are managed by SSO Configured IDPs

    Default value is false.

  • Flags array[object]
    Hide Flags attributes Show Flags attributes object

    • CreatedAt string(date-time)
    • Id string

      Unique ID of the flag

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

    • UpdatedAt string(date-time)
    • AccessLevel integer Required

      The access level of a flag as a number. The higher the number, the more sensitive it is

    • Description string

      The description of this flag

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

    • Name string Required

      The name of this flag

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

    • Status string Required

      Current status of this resource

      Values are Active or Inactive. Default value is Active.

    • Type string Required

      The type of this tag

      Values are Organisation, Software_Statement, or Authorisation_Server.

    • Value string Required

      The value of this flag

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

  • LegalEntityName string

    Legal Entity name for the org. Usually the same as org name

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

  • LogoUri string(uri)

    A compliant URI

    Format should match the following pattern: ^(http://|https://).*.(svg|png|jpg|jpeg)$|(data:image/[a-zA-Z0-9;+=-]+,[A-Za-z0-9+/]*={0,2})$.

  • OrganisationId string

    Unique ID associated with the organisation

    Minimum length is 1, maximum length is 40. Format should match the following pattern: ^[^<>]*$.

  • OrganisationName string

    Name of the organisation.

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

  • ParentOrganisationReference string

    Parent Organisation Reference

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

  • Postcode string

    Postcode

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

  • RegisteredName string

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

  • RegistrationId string

    Registered ID for the organisation i.e. Legal Entity identifier number

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

  • RegistrationNumber string

    Company registration number from company register i.e. Companies House registration number

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

  • RequiresParticipantTermsAndConditionsSigning boolean

    true - this organisation requires terms and conditions to be signed. false - this organisation does not require terms and conditions to be signed

  • Size string

    Size of the organisation

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

  • Status string

    Status of the directory registration of an organisation

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

  • TaxRegistrationNumber string

    Company tax registration number

    Minimum length is 1, maximum length is 255. Format should match the following pattern: ^[^<>]*$.

• 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}$.

• 409

  Conflict

  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}$.