---
reference:
  curl:
    - key: get_organization_by_external_id
      id: get_organization_by_external_id
      url: /reference/organization/get-by-external-id
      title: '/organizations/external_id/:external_id'
      type: GET
      parameters:
        - key: external_id
          type: string
          description: (organization.external_id)
      returns:
        - (organization)
  js:
    - key: getOrganizationByExternalId
      id: get_organization_by_external_id
      url: /reference/organization/get-by-external-id
      title: organizations.getOrganizationByExternalId()
      parameters:
        - key: externalId
          type: string
          description: (organization.external_id)
      returns:
        - (Organization)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/organization/get-by-external-id.mdx
---

## Get an Organization by External ID

Get the details of an existing organization by an [external identifier](/authkit/metadata/external-identifiers).

<CodeBlock referenceId="get_organization_by_external_id">
  <CodeBlockTab
    title="Request"
    file="get-organization-by-external-id-request"
  />
  <CodeBlockTab title="Response" file="get-organization-response" />
</CodeBlock>