Griffin

Griffin Organizations API

The organization resource represents your company and acts as a container for the majority of other resources, including [legal persons](#tag/Legal-Persons) and [bank accounts](#tag/Bank-accounts). When you register for an account with Griffin, a new [organization](#tag/Organizations) is created alongside your [user](#tag/Users) account (unless you have received an [invitation](#tag/Invitations) to join an existing organization). Your [user](#tag/Users) account is associated with an [organization](#tag/Organizations) via a [membership](#tag/Memberships). Your [organization](#tag/Organization) can be in one of two modes: - `test-mode` for organizations created when you sign up for the sandbox. - `live-mode` for when you go live with Griffin. Learn more about [sandbox vs. live mode](/docs/guides/sandbox-vs-live-mode).

Documentation GitHub OpenAPI

Operations 1

GET /v0/organizations/{organization-id} Get organization #

Documentation

📖

Documentation

https://docs.griffin.com/

📖

APIReference

https://docs.griffin.com/api

📖

GettingStarted

https://docs.griffin.com/docs/guides/get-started-with-the-api

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/griffin/refs/heads/main/openapi/griffin-organizations-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/griffin-organizations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Griffin Organizations API
  version: ''
  description: '## Introduction


    The Griffin API is based on REST.'
servers:
- url: https://api.griffin.com/
security:
- api-key-auth: []
tags:
- name: Organizations
  description: The organization resource represents your company and acts as a container for the majority of other resources, including legal persons and bank accounts.
paths:
  /v0/organizations/{organization-id}:
    get:
      tags:
      - Organizations
      description: Yields the organization details
      parameters:
      - required: true
        name: organization-id
        in: path
        schema:
          type: string
      responses:
        '200':
          headers:
            Location:
              description: The URL of the organization
              schema:
                type: string
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  own-legal-person-url:
                    type: string
                    x-allOf:
                    - type: string
                    - {}
                    - type: object
                      properties:
                        legal-person-id:
                          type: string
                          format: ''
                          title: legal-person-id
                          required: true
                          name: legal-person-id
                      required:
                      - legal-person-id
                    x-anyOf:
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          legal-person-id:
                            type: string
                            format: ''
                            title: legal-person-id
                            required: true
                            name: legal-person-id
                        required:
                        - legal-person-id
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          legal-person-id:
                            type: string
                            format: ''
                            title: legal-person-id
                            required: true
                            name: legal-person-id
                        required:
                        - legal-person-id
                    title: own-legal-person-url
                    description: Link to the [legal person](#tag/Legal-persons) that represents the [organization](#tag/Organizations); this can be an individual or a company.
                    example: /v0/legal-persons/lp.IGxlZ2FsLXBlcnNvbi1pZA
                  organization-mode:
                    title: organization-mode
                    enum:
                    - test-mode
                    - live-mode
                    type: string
                    description: The organization can either be a sandbox organization or a live one; Check out our guide for [sandbox mode vs live mode](/docs/guides/sandbox-vs-live-mode).
                  organization-memberships-url:
                    type: string
                    title: organization-memberships-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/memberships
                    description: Link to the [memberships](#tag/Memberships) for this [organization](#tag/Organizations).
                  organization-invitations-url:
                    type: string
                    title: organization-invitations-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/invitations
                    description: Link to the resource that enables you to [invite](#tag/Invites) new [users](#tag/Users) to this [organization](#tag/Organizations).
                  organization-payments-url:
                    type: string
                    x-allOf:
                    - type: string
                    - {}
                    - type: object
                      properties:
                        organization-id:
                          type: string
                          format: ''
                          title: organization-id
                          required: true
                          name: organization-id
                      required:
                      - organization-id
                    x-anyOf:
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          organization-id:
                            type: string
                            format: ''
                            title: organization-id
                            required: true
                            name: organization-id
                        required:
                        - organization-id
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          organization-id:
                            type: string
                            format: ''
                            title: organization-id
                            required: true
                            name: organization-id
                        required:
                        - organization-id
                    title: organization-payments-url
                    description: Link to the [payments](#tag/Payments) associated with this organization.
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/payments
                  organization-bank-account-products-url:
                    type: string
                    x-allOf:
                    - type: string
                    - {}
                    - type: object
                      properties:
                        organization-id:
                          type: string
                          format: ''
                          title: organization-id
                          required: true
                          name: organization-id
                      required:
                      - organization-id
                    x-anyOf:
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          organization-id:
                            type: string
                            format: ''
                            title: organization-id
                            required: true
                            name: organization-id
                        required:
                        - organization-id
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          organization-id:
                            type: string
                            format: ''
                            title: organization-id
                            required: true
                            name: organization-id
                        required:
                        - organization-id
                    title: organization-bank-account-products-url
                    description: Link to the [bank account](#tag/Bank-accounts) products owned by this [organization](#tag/Organization).
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/bank/products
                  organization-onboarding-applications-url:
                    type: string
                    title: organization-onboarding-applications-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/onboarding/applications
                    description: Link to the [Reliance onboarding](#tag/Reliance-onboarding).
                  display-name:
                    type: string
                    minLength: 1
                    title: display-name
                    description: The mutable display name for the Organisation
                    maxLength: 64
                    example: Company Org
                  organization-bank-accounts-search-url:
                    type: string
                    x-allOf:
                    - type: string
                    - {}
                    - type: object
                      properties:
                        organization-id:
                          type: string
                          format: ''
                          title: organization-id
                          required: true
                          name: organization-id
                      required:
                      - organization-id
                    x-anyOf:
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          organization-id:
                            type: string
                            format: ''
                            title: organization-id
                            required: true
                            name: organization-id
                        required:
                        - organization-id
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          organization-id:
                            type: string
                            format: ''
                            title: organization-id
                            required: true
                            name: organization-id
                        required:
                        - organization-id
                    title: organization-bank-accounts-search-url
                    description: Link to search [bank accounts](#tag/Bank-accounts) associated with this [organization](#tag/Organizations).
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/bank/accounts/search
                  organization-api-keys-url:
                    type: string
                    title: organization-api-keys-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/api-keys
                  organization-live-access-url:
                    type: string
                    title: organization-live-access-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/live-access
                    description: Link to the resource that enables you to request live access.
                  organization-webhooks-url:
                    type: string
                    title: organization-webhooks-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/webhooks
                    description: Link to the endpoint which enables webhook creation.
                  organization-workflows-url:
                    type: string
                    title: organization-workflows-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/workflows
                    description: Link to the onboarding [workflows](#tag/Workflows) configured for this [organization](#tag/Organizations).
                  organization-bank-accounts-url:
                    type: string
                    title: organization-bank-accounts-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/bank/accounts
                    description: Link to the [bank accounts](#tag/Bank-accounts) managed by this [organization](#tag/Organizations).
                  available-roles:
                    type: array
                    items:
                      type: object
                      properties:
                        display-name:
                          type: string
                          minLength: 1
                          title: display-name
                          description: The mutable display name for the Organisation
                          maxLength: 64
                          example: Company Org
                        description:
                          type: string
                          title: description
                        role-url:
                          type: string
                          x-allOf:
                          - type: string
                          - {}
                          - type: object
                            properties:
                              role-id:
                                type: string
                                format: ''
                                title: role-id
                                required: true
                                name: role-id
                            required:
                            - role-id
                          x-anyOf:
                          - type: string
                            x-allOf:
                            - type: string
                            - {}
                            - type: object
                              properties:
                                role-id:
                                  type: string
                                  format: ''
                                  title: role-id
                                  required: true
                                  name: role-id
                              required:
                              - role-id
                          - type: string
                            x-allOf:
                            - type: string
                            - {}
                            - type: object
                              properties:
                                role-id:
                                  type: string
                                  format: ''
                                  title: role-id
                                  required: true
                                  name: role-id
                              required:
                              - role-id
                          title: role-url
                          description: Link to the [role](#tag/Roles).
                          example: /v0/roles/re.ICAgICAgICAgcm9sZS1pZA
                        role-category:
                          type: string
                      required:
                      - display-name
                      - description
                      - role-url
                      title: role
                    description: The subset of [roles](#tag/Roles) available to [members](#tag/Members) of this [organization](#tag/Organizations).
                    title: available-roles
                  organization-url:
                    type: string
                    title: organization-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA
                    description: Link to the [organization](#tag/Organizations).
                  organization-payments-search-url:
                    type: string
                    x-allOf:
                    - type: string
                    - {}
                    - type: object
                      properties:
                        organization-id:
                          type: string
                          format: ''
                          title: organization-id
                          required: true
                          name: organization-id
                      required:
                      - organization-id
                    x-anyOf:
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          organization-id:
                            type: string
                            format: ''
                            title: organization-id
                            required: true
                            name: organization-id
                        required:
                        - organization-id
                    - type: string
                      x-allOf:
                      - type: string
                      - {}
                      - type: object
                        properties:
                          organization-id:
                            type: string
                            format: ''
                            title: organization-id
                            required: true
                            name: organization-id
                        required:
                        - organization-id
                    title: organization-payments-search-url
                    description: Link to search [payments](#tag/Payments) associated with this organization.
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/payments/search
                  organization-individuals-url:
                    type: string
                    title: organization-individuals-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/individuals
                  organization-corporations-url:
                    type: string
                    title: organization-corporations-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/corporations
                  organization-legal-persons-url:
                    type: string
                    title: organization-legal-persons-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/legal-persons
                    description: Link to the [legal persons](#tag/Legal-persons) grouped under this [organization](#tag/Organizations).
                  organization-legal-persons-search-url:
                    type: string
                    title: organization-legal-persons-search-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/legal-persons/search
                    description: Link to search [legal persons](#tag/Legal-persons) grouped under this [organization](#tag/Organizations).
                  organization-events-url:
                    type: string
                    title: organization-events-url
                    example: /v0/organizations/og.IG9yZ2FuaXphdGlvbi1pZA/events
                    description: Link to the endpoint which lists an organization's events.
                required:
                - available-roles
                - can-decide-on-verifications?
                - display-name
                - organization-api-keys-url
                - organization-bank-accounts-url
                - organization-bank-account-products-url
                - organization-corporations-url
                - organization-events-url
                - organization-individuals-url
                - organization-invitations-url
                - organization-legal-persons-url
                - organization-live-access-url
                - organization-memberships-url
                - organization-mode
                - organization-payments-url
                - organization-url
                - organization-webhooks-url
                - organization-workflows-url
                - own-legal-person-url
                - organization-legal-persons-search-url
                - organization-bank-accounts-search-url
                - organization-payments-search-url
                title: organization
                additionalProperties: false
        '400':
          description: ''
        '401':
          description: Requires an API key to continue
          headers:
            www-authenticate:
              description: Returns `GriffinSession` if no valid authentication is found.
              schema:
                type: string
        '404':
          description: ''
      summary: Get organization
      operationId: getV0OrganizationsByOrganizationId
      x-operation-id-source: derived
components:
  securitySchemes:
    api-key-auth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API token authentication.

        It should follow the format: `GriffinAPIKey g-test-MyKey-XXXXXXX`'
x-tagGroups:
- name: Getting started
  tags:
  - API keys
  - Connectivity
  - Navigation
  - Events
  - Webhooks
  - Message Signatures
- name: Customer verifications
  tags:
  - Legal persons
  - Legal person history
  - Claims
  - Workflows
  - Verifications
  - Decisions
  - Companies House
  - Reliance onboarding
- name: Banking
  tags:
  - Bank accounts
  - Bank account events
  - Bank account restrictions
  - Bank account holds
  - Pooled account membership
  - Payments
  - Transactions
  - Payees
  - Confirmation of payee
  - Open banking
- name: Team management
  tags:
  - Organizations
  - Users
  - Roles
  - Memberships
  - Invitations
x-id:
- default