> ## Documentation Index
> Fetch the complete documentation index at: https://docs.etherfuse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get KYB status

> Returns a business organization's KYB verification status so you can track your customer's progress without portal access. The response is the same shape the `kyb_updated` webhook delivers, so subscribe to that webhook to be told the moment it changes, and use this endpoint to read the current state (after downtime, or to reconcile).

The target org must be a business org you own (your own org or a direct child).



## OpenAPI

````yaml /openapi.json get /ramp/organization/{id}/kyb/status
openapi: 3.1.0
info:
  title: Etherfuse FX API
  description: Partner-facing ramp API for onramps, offramps, swaps, and KYC.
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sand.etherfuse.com
    description: Sandbox
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: >-
      Partner JWT authentication — exchange a JWT for an access token, or launch
      a user into the app.
  - name: Lookup
    description: >-
      Public reference data: exchange rates, stablebonds, bond costs, country
      codes.
  - name: Assets
    description: Rampable stablecoins and stablebonds available per blockchain.
  - name: Bank Accounts
    description: Register and retrieve customer bank accounts.
  - name: Quotes
    description: Price quotes for onramps, offramps, and swaps.
  - name: Orders
    description: Create, track, and manage ramp orders.
  - name: Swaps
    description: Crypto-to-crypto swaps.
  - name: Sponsored
    description: Token approvals for sponsored (gasless) offramps.
  - name: Customers
    description: Customer (child-organization) records.
  - name: Wallets
    description: Register and manage customer wallets.
  - name: KYC
    description: >-
      Submit a customer's verification data, documents and questionnaire
      answers, import a verification they already passed elsewhere, and check
      where their KYC stands.
  - name: Webhooks
    description: Event notification subscriptions.
  - name: Organizations
    description: Organization identity, child orgs, and partner fees.
  - name: Statements
    description: >-
      Monthly revenue share statements for closed months, as a list or as a CSV
      or PDF download.
  - name: Deprecated
    description: >-
      Endpoints kept working until their sunset date and then removed. See the
      deprecations page for replacements and dates.
paths:
  /ramp/organization/{id}/kyb/status:
    get:
      tags:
        - Organizations
      summary: Get KYB status
      description: >-
        Returns a business organization's KYB verification status so you can
        track your customer's progress without portal access. The response is
        the same shape the `kyb_updated` webhook delivers, so subscribe to that
        webhook to be told the moment it changes, and use this endpoint to read
        the current state (after downtime, or to reconcile).


        The target org must be a business org you own (your own org or a direct
        child).
      operationId: partner_get_kyb_status
      parameters:
        - name: id
          in: path
          description: The business organization.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: KYB verification state for the organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KybStatusResponse'
        '403':
          description: Not permitted to view this organization
        '404':
          description: Organization not found
components:
  schemas:
    KybStatusResponse:
      type: object
      description: >-
        An organization's KYB verification state: the same shape the
        [`kyb_updated` webhook](/api-reference/webhooks/kyb_updated) delivers,
        so you can poll or subscribe without learning two payloads.
      required:
        - organizationId
        - status
        - approvedAt
      properties:
        organizationId:
          type: string
          format: uuid
          description: ID of the business organization this KYB belongs to.
        status:
          type: string
          enum:
            - not_started
            - in_progress
            - submitted
            - approved
            - denied
          description: >-
            The KYB status. `not_started`: verification hasn't begun.
            `in_progress`: the customer has something left to submit.
            `submitted`: everything the customer can do is done and it's
            Etherfuse's turn, including an open note the customer is waiting on
            an answer to. A note Etherfuse has asked the customer to answer
            reads `in_progress`. `approved`: KYB approved, the business can
            transact. `denied`: KYB denied.
        approvedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            When the organization was approved, or null if it is not approved
            yet.
      example:
        organizationId: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        status: submitted
        approvedAt: null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API key sent in the Authorization header.

````