# フォーム送信API

> Formspree Docs · フォームAPI · 2025年12月18日

#### 利用可能なプラン: Professional、Business

フォームAPIを使用する前に、まず[フォームのAPIキーを作成](/articles/the-forms-api/api-keys/)し、[認証済みリクエスト](/articles/the-forms-api/api-authentication/)を作成して、[フォームのhashid](/articles/the-forms-api/getting-your-form-s-hashid/)を取得する必要があります。

## 送信データの取得

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

すべての送信データを取得します。

例：

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

レスポンスの例：

```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
        }
      }
    },
    ...
  ]
}
```

### 結果のフィルタリング

送信データ取得エンドポイントにURLパラメーターを渡すことで、結果をフィルタリングできます。

#### since

`since`パラメーターを使用して、指定日以降のすべての送信データを取得します。日付は`2018-11-03T12:00:00`のようにISO形式で指定する必要があります。

例：

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

#### limit

`limit`パラメーターを使用して、結果の件数を制限します。

例：

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

#### offset

`offset`パラメーターをページネーションのカーソルとして使用します。前のクエリより前の送信データを表示するために`limit`と組み合わせて使用することが多いです。

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

#### order

`order`パラメーターを使用して並び順を変更します。デフォルトの順序は`desc`（降順）です。

例：

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

#### spam

`spam`パラメーターを使用して、スパムとしてフラグが立てられたまたはマークされたメッセージを返します。デフォルトではこの値は`false`です。

例：

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

\* 注：この機能はまだ完全に展開されていません。すべてのアカウントで利用可能になった際に更新します。