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

# Fetch enablement status

> Fetch the current DIAN enablement state of a registered supplier.

Returns the supplier's current DIAN enablement state: `status` is omitted until a test set has been submitted, then moves through `pending` to `accepted` or `failed`.

<Note>
  Use this endpoint to drive your own onboarding UI instead of the hosted portal. The silo entry must belong to the authenticated workspace and have been registered with the Colombia app first.
</Note>


## OpenAPI

````yaml GET /apps/gov-co/v1/entries/{silo_entry_id}/enablement
openapi: 3.1.0
info:
  contact:
    email: dev@invopop.com
    name: Invopop Developers
  description: >-
    Set of end-points for the Colombia app, covering the DIAN enablement and
    numbering resolutions of registered suppliers.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  title: Colombia Service API
  version: 0.1.0
servers:
  - description: production
    url: https://api.invopop.com
security:
  - InvopopAuth: []
paths:
  /apps/gov-co/v1/entries/{silo_entry_id}/enablement:
    get:
      summary: Fetch the enablement status
      description: Fetch the current DIAN enablement state of a registered supplier.
      operationId: fetchEnablement
      parameters:
        - $ref: '#/components/parameters/SiloEntryID'
      responses:
        '200':
          description: The supplier's current enablement state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Enablement'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    SiloEntryID:
      name: silo_entry_id
      in: path
      required: true
      description: ID of the `org.Party` silo entry the supplier was registered with.
      schema:
        type: string
        example: 5b45453c-cdd0-11ed-afa1-0242ac120002
  schemas:
    Enablement:
      type: object
      properties:
        status:
          type: string
          description: |-
            Current enablement state. Omitted until a test set has been
            submitted.

              - `pending`: test set submitted, awaiting the DIAN outcome.
              - `accepted`: the DIAN accepted the test set; the supplier is enabled.
              - `failed`: the DIAN rejected the test set or the submission failed.
          enum:
            - pending
            - accepted
            - failed
          example: pending
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable description of the error.
          example: the DIAN TestSetId is required
  responses:
    Unauthorized:
      description: Missing or invalid authentication token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: missing enrollment
    NotFound:
      description: |-
        The referenced silo entry has no registered supplier account in the
        authenticated workspace. Run the registration workflow first.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: not found
    InternalServerError:
      description: An unexpected server-side error occurred.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: internal error
  securitySchemes:
    InvopopAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        Authenticate using a valid Invopop enrollment token in the `Bearer`
        scheme.

        Example: `Authorization: Bearer <token>`

````

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