# API de envíos de formulario

> Formspree Docs · La API de formularios · 18 de diciembre de 2025

#### Disponible en: planes Professional y Business

Antes de poder utilizar las APIs de formularios, primero necesitas [crear las claves de API de tu formulario](/es/articles/the-forms-api/api-keys/), crear una [solicitud autenticada](/es/articles/the-forms-api/api-authentication/) y obtener el [hashid de tu formulario](/es/articles/the-forms-api/getting-your-form-s-hashid/). 

## Obtener envíos

```http
GET https://formspree.io/api/0/forms/<hashid>/submissions
```

Obtén todos tus envíos.

Ejemplo:

```bash
curl -u :API_KEY https://formspree.io/api/0/forms/<hashid>/submissions
```

Ejemplo de resultado:

```json
{
  "fields": [
    "_date", 
    "email", 
    "message",
    "_status"
  ], 
  "submissions": [
    {
      "_date": "2018-11-03T07:28:29.707632", 
      "email": "myemail@example.com", 
      "message": "asdfasdf",
      "_status": {
        "my@email.com": {
          "delivered": true,
          "processed": true,
          "dispatched": true
        },
        "plugin:discord": {
          "processed": true
        }
      }
    },
    ...
  ]
}
```

### Filtrado de resultados

Puedes filtrar los resultados pasando parámetros de URL al endpoint Get Submissions.

#### since

Utiliza el parámetro `since` para obtener todos los envíos a partir de una fecha. Las fechas deben tener formato ISO, como `2018-11-03T12:00:00`.

Ejemplo:

```bash
curl https://formspree.io/api/0/forms/<hashid>/submissions?since=2018-11-03T12:00:00
```

#### limit

Utiliza el parámetro `limit` para limitar la cantidad de resultados.

Ejemplo:

```bash
curl https://formspree.io/api/0/forms/<hashid>/submissions?limit=10
```

#### offset

Utiliza el parámetro `offset` como cursor en la paginación. Se usa con frecuencia junto con limit, de modo que puedas ver envíos anteriores a tu consulta previa.

```bash
curl https://formspree.io/api/0/forms/<hashid>/submissions?offset=10
```

#### order

Utiliza el parámetro `order` para cambiar el orden. De forma predeterminada, el orden es `desc`.

Ejemplo:

```bash
curl https://formspree.io/api/0/forms/<hashid>/submissions?order=asc
```

#### spam

Utiliza el parámetro `spam` para devolver los mensajes que han sido marcados o señalados como spam. De forma predeterminada, este valor es `false`.

Ejemplo:

```bash
curl https://formspree.io/api/0/forms/<hashid>/submissions?spam=true
```

\* nota: funcionalidad que aún no se ha implementado por completo. Actualizaremos esto cuando la opción esté disponible para todas las cuentas.