# Transfer a Name

### Transfer a Name

> Code samples

```javascript
const inputBody = '{
  "name": "string",
  "transferAddress": "string",
  "signature": "string",
  "message": "string",
  "createdAt": 0,
  "id": "string"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json'
};

fetch('https://tna-btc.com/api/tapname/transfer',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

```

`POST /api/tapname/transfer`

> Body parameter

```json
{
  "name": "string",
  "transferAddress": "string",
  "signature": "string",
  "message": "string",
  "createdAt": 0,
  "id": "string"
}
```

#### Parameters <a href="#transfer-tapname-parameters" id="transfer-tapname-parameters"></a>

| Name            | Type           | Required | Restrictions | Description              |
| --------------- | -------------- | -------- | ------------ | ------------------------ |
| name            | string(string) | true     | none         | transferred tapname      |
| transferAddress | string(string) | true     | none         | received tapname address |
| signature       | string(string) | true     | none         | signature                |
| message         | string(string) | true     | none         | signed message           |
| createdAt       | integer(int)   | true     | none         | current timestamp        |
| id              | string(string) | true     | none         | signature generated id   |

> Example responses

> 200 Response

```json
{
  "code": 0,
  "message": "string",
  "data": {}
}
```

#### Responses <a href="#transfer-tapname-responses" id="transfer-tapname-responses"></a>

| Status | Meaning | Description       | Schema |
| ------ | ------- | ----------------- | ------ |
| 200    | Success | none              | Inline |
| 400    | Failed  | see error message | Inline |

#### Response Schema <a href="#transfer-tapname-responseschema" id="transfer-tapname-responseschema"></a>

Status Code **200**

| Name      | Type           | Required | Restrictions | Description   |
| --------- | -------------- | -------- | ------------ | ------------- |
| » code    | integer(int)   | false    | none         | Error code    |
| » message | string(string) | false    | none         | Error message |
| » data    | object         | false    | none         | Result data   |
