# Extend a supply

This method allows a TEOS user to extend the expiration of an existing supply. Supply represents an offer created by a user to trade a specific amount of one asset for a specific amount of another asset. By extending a supply, the user can keep it active for a longer period, allowing other users to execute trades or participate in warps using this supply.

📘[ Learn more ](https://teos-docs.coreledger.net/resources/using-the-teos-api/concepts/supply)about supplies.

#### **Request Endpoint**

```http
POST
/odata/v1.0/Supplies({key})/Extend
```

**Preconditions:**

* The supply must exist.
* The supply must not be expired or deleted.

#### Parameters

| **Name** | **Type** | **Description**                        | **Mandatory** |
| -------- | -------- | -------------------------------------- | ------------- |
| key      | string   | The identifier of the supply to extend | ✅             |

#### Example request

```http
POST /Supplies('0x1EAEFD42D684567ABDC7000193A96C4653DE1314DB20000167242CB20000024E')/Extend
```

**Content-Type:**  `application/json` 

```json
    "expiryTime": "2024-02-15T23:25:24.295Z"
}
```

#### Example response

```json
{
  "Id": "C0D34D73-6FD3-40F2-A7E1-08D9412448F7",
  "State": "3",
  "BlockchainTransactionId": "0x748ac47e7226cae0e4e13373375f33ab9e4d43ef29d85d233162a7e7e913703b",
  "CorrelationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Type": "ActivateAsset",
  "OnCreated": "2025-10-08T09:43:32.429Z",
  "OnUpdated": "2025-10-08T09:43:32.429Z",
  "OnSubmitted": "2025-10-08T09:43:32.429Z",
  "OnCommitted": "2025-10-08T09:43:32.429Z",
  "OnConfirmed": "2025-10-08T09:43:32.429Z",
  "OnRevokedByBlockchain": "2025-10-08T09:43:32.429Z",
  "OnRevokedByUser": "2025-10-08T09:43:32.429Z",
  "OnRevokedByTxServer": "2025-10-08T09:43:32.429Z",
  "SignedBy": "string",
  "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "GasPrice": "string",
  "GasUsed": "string",
  "DataAsJson": "string",
  "SigningParametersAsJson": "string"
}
```

#### Response Fields Description

| **Field**               | **Type** | **Description**                                            |
| ----------------------- | -------- | ---------------------------------------------------------- |
| Id                      | string   | Identifier of the transaction                              |
| State                   | string   | Current state of the transaction                           |
| BlockchainTransactionId | string   | ID of the transaction on blockchain                        |
| CorrelationId           | string   | Correlation identifier for tracking                        |
| Type                    | string   | Type of the transaction                                    |
| OnCreated               | datetime | Timestamp when the transaction was created                 |
| OnUpdated               | datetime | Timestamp when the transaction was last updated            |
| OnSubmitted             | datetime | Timestamp when the transaction was submitted               |
| OnCommitted             | datetime | Timestamp when the transaction was committed               |
| OnConfirmed             | datetime | Timestamp when the transaction was confirmed               |
| OnRevokedByBlockchain   | datetime | Timestamp if transaction was revoked by blockchain         |
| OnRevokedByUser         | datetime | Timestamp if transaction was revoked by user               |
| OnRevokedByTxServer     | datetime | Timestamp if transaction was revoked by transaction server |
| SignedBy                | string   | Address or identifier of the signer                        |
| CreatedBy               | string   | Identifier of the creator of the transaction               |
| GasPrice                | string   | Gas price used in blockchain transaction                   |
| GasUsed                 | string   | Gas consumed for transaction execution                     |
| DataAsJson              | string   | Additional data in JSON format                             |
| SigningParametersAsJson | string   | Signing parameters in JSON format                          |

#### Responses

| **Code** | **Description**                                                  |
| -------- | ---------------------------------------------------------------- |
| 201      | The transaction was successfully created                         |
| 202      | Accepted                                                         |
| 400      | The supply extension data is invalid. Error details are included |
| 401      | Unauthorized                                                     |

<br>