# Request

## request

> Initiate the delivery of a 2FA code to a recipient.

```json
{"openapi":"3.1.0","info":{"title":"messaging-2fa-api","version":"1.0"},"servers":[{"url":"https://messaging-api.bind.hr"}],"security":[{"default":[]}],"components":{"securitySchemes":{"default":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v1.0/2fa/request":{"post":{"summary":"request","description":"Initiate the delivery of a 2FA code to a recipient.","operationId":"2fa-api-request-endpoint","tags":["Request"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["to","template_id"],"properties":{"to":{"type":"string","description":"The destination number for the 2FA message.","default":"447916123456"},"template_id":{"type":"string","description":"The id of the template which is being sent to the recipient","default":"11bf5b37-e0b8-42e0-8dcf-dc8c4aefc123"},"parameters":{"type":"object","description":"A list of key-value parameters to be applied to the template. Note that `${code}` is a reserved parameter and will be ignored if provided.","required":["key"],"properties":{"key":{"type":"string","default":"value"}}}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"status":{"type":"string"},"request_id":{"type":"string"},"error_message":{"type":"string"}}},{"title":"Rejected","type":"object","properties":{"status":{"type":"string"},"request_id":{"type":"string"},"error_message":{"type":"string"}}}]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"property":{"type":"string"},"error":{"type":"string"}}}}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"error_message":{"type":"string"}}}}}},"429":{"description":"429","content":{"application/json":{"schema":{"type":"object","properties":{"error_message":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"error_message":{"type":"string"}}}}}}},"deprecated":false}}}}
```