> For the complete documentation index, see [llms.txt](https://help.join.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.join.com/help-center/es/integrations-and-api/api-documentation.md).

# Documentación de la API

Crea un token de API de JOIN, autentica tus solicitudes a la API v3 de JOIN y descubre cómo funcionan las versiones, los límites de uso, la paginación y los errores.

{% hint style="info" %}
**Quién puede usarlo**

* **Planes:** Advanced y Enterprise
* **Roles:** Administradores del sistema
  {% endhint %}

## Primeros pasos

Esta referencia te ayuda a empezar con la API v3 de JOIN, la API REST de JOIN. La API te permite trabajar con tus datos de JOIN de forma programática, por ejemplo, para obtener ofertas, recuperar candidaturas o gestionar registros de candidatos.

La API de JOIN no tiene estado (es *stateless*): cada solicitud debe incluir la autenticación y no depende de interacciones anteriores. Para usar la API, tienes que crear un token de API en JOIN.

Todas las solicitudes de la v3 se envían a `https://api.join.com/v3`.

<a href="https://docs.join.com/reference/getting-started" class="button primary">Leer la documentación completa de la API</a>

***

## Autenticación

Para validar tus solicitudes a la API, JOIN necesita un token de API. El token pertenece a tu empresa, no a un usuario concreto, y solo da acceso a los datos de tu empresa en JOIN.

El acceso a la API de JOIN, incluidas las credenciales de API y la generación de tokens, solo está disponible en los planes `Advanced` y `Enterprise`.

{% hint style="info" %}
¿No ves la página `Desarrollador`? Solo los Administradores del sistema pueden abrirla. Si `Crear token` abre un aviso para mejorar el plan, comprueba tu plan: haz clic en tu nombre en la esquina inferior izquierda, selecciona `Configuración` y, después, `Facturación`. Cambia a `Advanced` o `Enterprise` para usar la API de JOIN y generar credenciales.

Consulta [Planes de suscripción](https://help.join.com/help-center/es/plans-and-billing/subscription-plans.md) para ver los detalles de los planes y cómo mejorar el tuyo.
{% endhint %}

### Generar un token de API

1. Haz clic en tu nombre en la esquina inferior izquierda y selecciona `Configuración`.
2. Selecciona `Desarrollador`.
3. Haz clic en `Crear token`, introduce un nombre y copia el token de la ventana que se abre. Solo se muestra una vez.

Tu empresa puede tener hasta 10 tokens activos.

{% hint style="warning" %}
Mantén tu token de API seguro. Da acceso a los datos de tu empresa en JOIN, incluida la posibilidad de leer, actualizar o eliminar información.
{% endhint %}

### Usar el token de API

Envía tu token en la cabecera `Authorization` de cada solicitud, como token Bearer: `Authorization: Bearer join_sk_…`. Los tokens nuevos empiezan por `join_sk_`.

Una solicitud sin token devuelve `401 authentication_required`. Un token no válido o revocado, o usado en un plan sin acceso a la API, devuelve `401 token_invalid`.

### Elegir una versión de la API

La API v3 de JOIN se versiona por fecha. Envía la cabecera `Join-Version` para elegir una versión. Sin ella, JOIN usa `2026-11-01`. Una versión desconocida devuelve `400 unsupported_api_version`.

Te recomendamos enviar `Join-Version` en cada solicitud para que tu integración siga funcionando cuando se publique una versión nueva. Consulta [Versiones y compatibilidad](https://docs.join.com/reference/versioning-and-depreciation).

**Ejemplo de solicitud:**

```bash
curl -X GET \
  https://api.join.com/v3/jobs \
  -H 'Authorization: Bearer your-api-token-here' \
  -H 'Join-Version: 2026-11-01'
```

### Revocar un token de API

Puedes revocar un token en cualquier momento en `Configuración` > `Desarrollador`. Ten en cuenta que:

* Una vez revocado, el token deja de funcionar inmediatamente
* Los tokens no se pueden reactivar ni regenerar
* Si revocas un token, tienes que actualizar tu integración con uno nuevo

***

## Límites de uso, paginación y errores

* **Límites de uso:** cada token puede enviar 600 solicitudes por minuto y, como máximo, 100 en cualquier intervalo de 10 segundos. Por encima de ese límite, la API devuelve `429 rate_limit_exceeded` con una cabecera `Retry-After` que indica cuándo volver a intentarlo.
* **Paginación:** las listas devuelven 10 registros de forma predeterminada, y `limit` acepta de 1 a 50. Para obtener la página siguiente, envía el `nextCursor` de la respuesta como `cursor`. En la última página, `nextCursor` es `null`.
* **Errores:** todos los errores llegan como `{"error": {"code", "message", "details"}}`. `details` indica los campos que no han superado la validación.

Para más detalles, consulta [Rate limits](https://docs.join.com/reference/rate-limits), [Pagination, filtering and sorting](https://docs.join.com/reference/pagination) y [Responses, errors and retries](https://docs.join.com/reference/requests-and-responses).

***

## API v2 de JOIN

La API v2 de JOIN está obsoleta. Crea las integraciones nuevas con la v3 y planifica el paso de las integraciones v2 existentes a la v3.

* Las claves de API v2 existentes se han migrado automáticamente a tokens de empresa. Sus valores no han cambiado, así que tus integraciones v2 siguen funcionando. Las encontrarás en `Configuración` > `Desarrollador`, con el nombre del administrador al que pertenecía la clave.
* Los tokens nuevos que crees en `Desarrollador` también funcionan con la v2.

Para pasar una integración de la v2 a la v3, consulta [Moving from v2 to v3](https://docs.join.com/reference/migration-guide-from-v2).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.join.com/help-center/es/integrations-and-api/api-documentation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
