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

> ## Agent Instructions
> Melso MCP: https://mcp.melso.ai/mcp (OAuth; one company per connection). Documentation-search MCP: https://docs.melso.ai/mcp; it does not act on customer accounts. Melso API: https://api.melso.ai/v1, invoicing only, with a company API key.
>
> Use the live tool list and respect company membership. Ask the person to approve the exact invoice or tax return version in the signed-in app. Melso's professionals prepare and file included returns after approval; an AI assistant does not file. A prepared file or an approval is not evidence of filing: only the AEAT's reference and receipt are. Keep credentials out of chat and logs.

# Estado de una empresa — Get a company

> Returns a company you opened, with its status.

> [!NOTE]
>
> **Early access.** Partner keys are issued on request: write to [hello@melso.ai](mailto:hello@melso.ai). See [Partner API](https://docs.melso.ai/api/partner/overview.md).

Once it is `ready`, it has its legal name and NIF.


## OpenAPI

````yaml api/partner-openapi.yaml GET /partner/companies/{company_id}
openapi: 3.1.0
info:
  title: Melso Partner API
  version: 0.1.0-early-access
  summary: Open companies in Melso for your customers.
  description: |
    Early access. A partner key works across the companies you open for your
    customers. Melso issues partner keys on request: write to
    hello@melso.ai. Melso's professionals carry out each incorporation and
    registration.
  contact:
    name: Melso
    email: hello@melso.ai
    url: https://docs.melso.ai/api/partner/overview
servers:
  - url: https://api.melso.ai/v1
security:
  - partnerApiKey: []
tags:
  - name: Partner companies
    description: Companies you open in Melso for your customers.
paths:
  /partner/companies/{company_id}:
    parameters:
      - name: company_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
    get:
      tags:
        - Partner companies
      summary: Get a company
      description: >
        Returns a company you opened, with its `status`. Once it is `ready`, it
        has its legal name and NIF.
      operationId: getPartnerCompany
      responses:
        '200':
          description: The company.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerCompany'
              example:
                id: 2c4d6e8f-0a1b-4c3d-9e5f-6a7b8c9d0e1f
                status: ready
                setup: incorporate_sl
                express: true
                external_id: cus_48215
                legal_name: Norte Servicios Digitales S.L.
                tax_id: B00000000
                created_at: '2026-11-21T10:05:43Z'
                ready_at: '2026-11-21T14:20:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    PartnerCompany:
      type: object
      required:
        - id
        - status
        - setup
        - express
        - external_id
        - legal_name
        - tax_id
        - created_at
        - ready_at
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - requested
            - in_progress
            - ready
            - cancelled
          description: >-
            `requested` when you create it, `in_progress` while Melso works on
            it, `ready` once it can invoice.
        setup:
          type: string
          enum:
            - incorporate_sl
            - register_autonomo
            - existing
        express:
          type: boolean
          description: '`true` for a company from Melso''s pool.'
        external_id:
          type:
            - string
            - 'null'
        legal_name:
          type:
            - string
            - 'null'
          description: Set once the company is `ready`.
        tax_id:
          type:
            - string
            - 'null'
          description: The company's NIF, set once it is `ready`.
        created_at:
          type: string
          format: date-time
        ready_at:
          type:
            - string
            - 'null'
          format: date-time
    Error:
      type: object
      required:
        - error
        - code
        - request_id
      properties:
        error:
          type: string
          description: What went wrong
          for a person to read.: null
        code:
          type: string
          description: A stable code to branch on.
        request_id:
          type: string
  responses:
    Unauthorized:
      description: The partner key is missing, revoked or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: No such company for this key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Too many requests. Wait `Retry-After` seconds.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    partnerApiKey:
      type: http
      scheme: bearer
      description: |
        A partner key, `mk_partner_…`, that Melso issues on request. Keep it on
        your servers.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.