Buk

Buk Recintos API

The Recintos API from Buk — 3 operation(s) for recintos.

GitHub OpenAPI

Operations 4

GET /informacionRecinto Recinto #
GET /recintos Show Recintos #
POST /recintos Create Recinto #
PATCH /recintos/{code} Upgrade Recinto #

Documentation

📖
Documentation
https://demo.buk.cl/apidocs
📖
APIReference
https://demo.buk.cl/apidocs
📖
GettingStarted
https://supportcenter.buk.cl/hc/es-419/articles/36657679009307-C%C3%B3mo-integrarse-a-Buk-a-trav%C3%A9s-de-API
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/buk/refs/heads/main/authentication/buk-authentication.yml
📖
Documentation
https://app.swaggerhub.com/apis-docs/BUKASISTENCIA/ApiAsistencia/1.0.0
📖
APIReference
https://app.swaggerhub.com/apis-docs/BUKASISTENCIA/ApiAsistencia/1.0.0
📖
GettingStarted
https://supportcenter.buk.cl/hc/es-419/articles/50240904785051-APIs-de-Buk-Asistencia
📖
Documentation
https://app.swaggerhub.com/apis-docs/BUKASISTENCIA/AttendanceBiometrics/1.0.0
📖
APIReference
https://app.swaggerhub.com/apis-docs/BUKASISTENCIA/AttendanceBiometrics/1.0.0

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/buk/refs/heads/main/openapi/buk-recintos-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/buk/refs/heads/main/asyncapi/buk-webhooks.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/buk/refs/heads/main/data-model/buk-data-model.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/buk-recintos-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

buk-recintos-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Buk Recintos API
  version: '1.0'
  description: 'Operations tagged Recintos across 2 of this provider''s published API definitions: buk-asistencia-api-openapi.json, buk-data-access-api-brasil-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- description: Production server
  url: https://app.ctrlit.cl/ctrl/api
- description: Production server app2
  url: https://app2.ctrlit.cl/ctrl/api
- url: https://demo.buk.cl/api/v1/brasil
tags:
- name: Recintos
paths:
  /informacionRecinto:
    get:
      tags:
      - Recintos
      description: Este endpoint proporciona una lista paginada de recintos pertenecientes a una empresa específica. Cada recinto incluye detalles como el nombre, dirección y ubicación.
      operationId: recinto
      parameters:
      - in: query
        name: page
        description: Número de la página. Si no se proporciona, se asume la primera página (1).
        schema:
          type: integer
      - in: query
        name: page_size
        description: Tamaño de la página, con un valor máximo permitido de 100. Si no se proporciona, se utiliza un tamaño de página predeterminado (25).
        schema:
          type: integer
      security:
      - ApiKeyAuth: []
      responses:
        '200':
          description: Respuesta exitosa que contiene la lista de recintos de una empresa. La respuesta está paginada y cada página incluye un subconjunto de recintos junto con información detallada de cada uno.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    type: object
                    properties:
                      next:
                        type: string
                        example: https://api.ejemplo.com/informacionRecinto?page=2
                      previous:
                        type:
                        - string
                        - 'null'
                        example: null
                      count:
                        type: integer
                        example: 34
                      page:
                        type: integer
                        example: 1
                      totalPages:
                        type: integer
                        example: 2
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        obra_id:
                          type: integer
                          example: 123
                        nombre:
                          type: string
                          example: Nombre de la obra
                        direccion:
                          type: string
                          example: Calle Falsa 123
                        comuna:
                          type: string
                          example: Comuna
                        region:
                          type: string
                          example: Region
                        pais:
                          type: string
                          example: Pais
        '400':
          description: 'Solicitud incorrecta. Este error se devuelve si unos de los parámetrros de la consulta no son válidos.

            '
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: 'Error: El tamaño de página (page_size) no está en el rango permitido.'
        '403':
          description: Acceso no autorizado. Se retorna cuando el token proporcionado es inválido, ha expirado o falta en el encabezado de la solicitud.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: 'Error: El token es inválido.'
        '405':
          description: Método de solicitud HTTP no permitido. Este endpoint solo admite solicitudes GET.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: No message available
      summary: Recinto
      x-summary-source: derived
    servers:
    - description: Production server
      url: https://app.ctrlit.cl/ctrl/api
    - description: Production server app2
      url: https://app2.ctrlit.cl/ctrl/api
  /recintos:
    get:
      summary: Show Recintos
      description: 'Retrieve information for each Recinto


        A Recinto has the following attributes::

        - name: Recinto name

        - code: Recinto code

        - location_id: ID of the Commune where the Recinto is located (you can check the endpoint GET /locations))

        - city: City

        - address_name: Street name of the Recinto

        - address_number: Street number of the Recinto

        - address_optional: Description of the address

        - latitude: Latitude of the Recinto

        - longitude: Recinto longitude

        - postcode: Recinto Zip Code

        - integrated_with_ctrl: Integration with CTRL

        - establishment_code: Recinto Code


        Este endpoint no requiere permisos especiales.'
      tags:
      - Recintos
      parameters:
      - name: code
        in: query
        description: '- code: Recinto code (OPTIONAL)'
        schema:
          type: string
      responses:
        '200':
          description: An array (data) with the information of the Recintos.
          name: data
          content:
            application/json:
              schema:
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RecintoIndex'
            application/pdf:
              schema:
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RecintoIndex'
        '400':
          description: There is an error with the data submitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
            application/pdf:
              schema:
                $ref: '#/components/schemas/bad_request'
      operationId: getRecintos
      x-operation-id-source: derived
    post:
      summary: Create Recinto
      description: 'Create a new Recinto in the system. The parameters are:


        - name: Recinto name

        - code: Recinto code

        - location_id: ID of the Recinto location (you can check the endpoint GET /locations)

        - address_name: Street name of the Recinto

        - address_number: Street number of the Recinto

        - address_optional: Address description (OPTIONAL)

        - latitude: Latitude of the Recinto (OPTIONAL)

        - longitude: Longitude of the Recinto (OPTIONAL)

        - postcode: Recinto Zip Code (OPTIONAL)

        - establishment_code: Recinto Code (OPTIONAL)


        **Permisos requeridos para utilizar este endpoint:**

        * Attendance permissions en: ''Lectura y Modificación''.'
      tags:
      - Recintos
      responses:
        '201':
          description: Recinto created.
          content:
            application/json:
              schema:
                title: ResponseBody
                properties:
                  data:
                    $ref: '#/components/schemas/Recinto__Response'
            application/pdf:
              schema:
                title: ResponseBody
                properties:
                  data:
                    $ref: '#/components/schemas/Recinto__Response'
        '400':
          description: There is an error with the data submitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
            application/pdf:
              schema:
                $ref: '#/components/schemas/bad_request'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Recinto__Create'
        description: Recinto object type.
        required: true
      operationId: postRecintos
      x-operation-id-source: derived
    servers:
    - url: https://demo.buk.cl/api/v1/brasil
  /recintos/{code}:
    patch:
      summary: Upgrade Recinto
      description: 'Updates an existing Recinto in the system. The parameters are:


        The entered values will overwrite the data of the Recinto being edited.


        - identifier: ID of existing Recinto

        - name: Recinto name (OPTIONAL)

        - code: Recinto code (OPTIONAL)

        - location_id: ID of the Recinto location (you can check the endpoint GET /locations) (OPTIONAL)

        - address_name: Street name of the Recinto (OPTIONAL)

        - address_number: Street number of the Recinto \ (OPTIONAL)

        - address_optional: Address description (OPTIONAL)

        - latitude: Latitude of the Recinto (OPTIONAL)

        - longitude: Longitude of the Recinto (OPTIONAL)

        - postcode: Recinto Zip Code (OPTIONAL)

        - establishment_code: Recinto Code (OPTIONAL)


        **Permisos requeridos para utilizar este endpoint:**

        * Attendance permissions en: ''Lectura y Modificación''.'
      tags:
      - Recintos
      parameters:
      - name: code
        in: path
        description: '- Existing Recinto code'
        required: true
        schema:
          type: string
      responses:
        '202':
          description: ''
          content:
            application/json:
              schema:
                title: ResponseBody
                description: Updated Recinto.
                properties:
                  data:
                    $ref: '#/components/schemas/Recinto__Response'
            application/pdf:
              schema:
                title: ResponseBody
                description: Updated Recinto.
                properties:
                  data:
                    $ref: '#/components/schemas/Recinto__Response'
        '400':
          description: There is an error with the data submitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
            application/pdf:
              schema:
                $ref: '#/components/schemas/bad_request'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Recinto__Update'
        description: Recinto object type.
        required: true
      operationId: patchRecintosByCode
      x-operation-id-source: derived
    servers:
    - url: https://demo.buk.cl/api/v1/brasil
components:
  schemas:
    Recinto__Update:
      allOf:
      - $ref: '#/components/schemas/Recinto'
    Pagination:
      properties:
        next:
          type: string
        previous:
          type: string
        count:
          type: integer
        total_pages:
          type: integer
    Recinto__Create:
      allOf:
      - $ref: '#/components/schemas/Recinto'
    Recinto__Response:
      properties:
        id:
          type: integer
          description: Identificador interno
      allOf:
      - $ref: '#/components/schemas/Recinto'
    Recinto:
      properties:
        name:
          type: string
          description: Nombre
        code:
          type: string
          description: Código
        location_id:
          type: integer
          description: Localidad
        address_name:
          type: string
          description: Calle
        address_number:
          type: string
          description: Número
        address_optional:
          type: string
          description: Descripción
        latitude:
          type: number
          description: Latitud
        longitude:
          type: number
          description: Longitud
        postcode:
          type: string
          description: Código Postal
        codigo_establecimiento:
          type: string
          description: Código Establecimiento
    bad_request:
      properties:
        errors:
          type: array
          items:
            type: string
    RecintoIndex:
      properties:
        name:
          type: string
          description: Nombre
        code:
          type: string
          description: Código
        location_id:
          type: integer
          description: Localidad
        city:
          type: string
          description: Ciudad
        address_name:
          type: string
          description: Calle
        address_number:
          type: string
          description: Número
        address_optional:
          type: string
          description: Descripción
        latitude:
          type: float
          description: Latitud
        longitude:
          type: float
          description: Longitud
        postcode:
          type: string
          description: Código Postal
        integrated_with_ctrl:
          type: boolean
          description: Integrado con CTRL
        codigo_establecimiento:
          type: string
          description: Código Establecimiento
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: token
    auth_token:
      type: apiKey
      name: auth_token
      in: header
x-refined-from:
- buk-asistencia-api-openapi.json
- buk-data-access-api-brasil-openapi.json