# POST /v4/ledger/claims

_Merkl API_

> Submit a recipient-signed claim intent to the coordinator

## Request body

**`application/json`**
```json
{
  "type": "object",
  "properties": {
    "recipient": {
      "type": "string"
    },
    "chainId": {
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Chain the claim pays out on",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 1,
          "maximum": 9007199254740991,
          "description": "Chain the claim pays out on",
          "type": "integer"
        }
      ]
    },
    "token": {
      "description": "Reward token address; \"\" = native (ETH/SOL)",
      "type": "string"
    },
    "amount": {
      "pattern": "^[1-9][0-9]*$",
      "maxLength": 78,
      "description": "Base units: a positive base-10 integer with no leading zero (`flow.PositiveUint256`)",
      "type": "string"
    },
    "nonce": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "type": "integer"
        }
      ]
    },
    "issuedAt": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix seconds",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Unix seconds",
          "type": "integer"
        }
      ]
    },
    "deadline": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix seconds",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Unix seconds",
          "type": "integer"
        }
      ]
    },
    "signature": {
      "description": "EIP-712 Claim signature (EVM), or the signature over the canonical claim message: hex ed25519 (SVM), base64 serialized signature (Sui)",
      "type": "string"
    }
  },
  "required": [
    "recipient",
    "chainId",
    "token",
    "amount",
    "nonce",
    "issuedAt",
    "deadline",
    "signature"
  ]
}
```
**`application/x-www-form-urlencoded`**
```json
{
  "type": "object",
  "properties": {
    "recipient": {
      "type": "string"
    },
    "chainId": {
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Chain the claim pays out on",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 1,
          "maximum": 9007199254740991,
          "description": "Chain the claim pays out on",
          "type": "integer"
        }
      ]
    },
    "token": {
      "description": "Reward token address; \"\" = native (ETH/SOL)",
      "type": "string"
    },
    "amount": {
      "pattern": "^[1-9][0-9]*$",
      "maxLength": 78,
      "description": "Base units: a positive base-10 integer with no leading zero (`flow.PositiveUint256`)",
      "type": "string"
    },
    "nonce": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "type": "integer"
        }
      ]
    },
    "issuedAt": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix seconds",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Unix seconds",
          "type": "integer"
        }
      ]
    },
    "deadline": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix seconds",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Unix seconds",
          "type": "integer"
        }
      ]
    },
    "signature": {
      "description": "EIP-712 Claim signature (EVM), or the signature over the canonical claim message: hex ed25519 (SVM), base64 serialized signature (Sui)",
      "type": "string"
    }
  },
  "required": [
    "recipient",
    "chainId",
    "token",
    "amount",
    "nonce",
    "issuedAt",
    "deadline",
    "signature"
  ]
}
```
**`multipart/form-data`**
```json
{
  "type": "object",
  "properties": {
    "recipient": {
      "type": "string"
    },
    "chainId": {
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Chain the claim pays out on",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 1,
          "maximum": 9007199254740991,
          "description": "Chain the claim pays out on",
          "type": "integer"
        }
      ]
    },
    "token": {
      "description": "Reward token address; \"\" = native (ETH/SOL)",
      "type": "string"
    },
    "amount": {
      "pattern": "^[1-9][0-9]*$",
      "maxLength": 78,
      "description": "Base units: a positive base-10 integer with no leading zero (`flow.PositiveUint256`)",
      "type": "string"
    },
    "nonce": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "type": "integer"
        }
      ]
    },
    "issuedAt": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix seconds",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Unix seconds",
          "type": "integer"
        }
      ]
    },
    "deadline": {
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix seconds",
      "anyOf": [
        {
          "format": "integer",
          "default": 0,
          "type": "string"
        },
        {
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Unix seconds",
          "type": "integer"
        }
      ]
    },
    "signature": {
      "description": "EIP-712 Claim signature (EVM), or the signature over the canonical claim message: hex ed25519 (SVM), base64 serialized signature (Sui)",
      "type": "string"
    }
  },
  "required": [
    "recipient",
    "chainId",
    "token",
    "amount",
    "nonce",
    "issuedAt",
    "deadline",
    "signature"
  ]
}
```

## Responses

- **200** Response for status 200

## Example request

```bash
curl -X POST "https://api.merkl.xyz//v4/ledger/claims" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }'
```