Check swap intent status

Checks the current status of a swap intent. Retrieves the intent's lifecycle state, associated transactions, and additional metadata.

get

/v1/intents/{intent_id}

---

Possible swap statuses

The status field represents the overall progress of the swap, combining both intent and swap state.

Status	Description
created	The intent has been created but no approval has been added yet.
approved	User has added approval/signature for the swap.
verified	Resolver has accepted the intent and is ready to execute.
failed	The intent was declined by the resolver.
deposited	Resolver has deposited user tokens on source network into the escrow.
finished	User has received funds on destination network in target token.
expired	The intent expired before execution.
refunded	Tokens have been refunded to the user.

---

Request

Header parameters

Requires authentication.

Query paramaters

Name	Type	Required	Description
intent_id	String	True	Swap intent ID.

Body parameters

Doesn't require setting any body parameters.

Sample query

https://defiapi.changelly.com/v1/intents/fe5601fb-60f2-4cb0-8a67-c55bd3640411

---

Response

Successful response

Name	Type	Required	Description
intent_id	Number	Required	Swap intent ID.
status	String	Required	Swap intent status. Possible values.
from	Object	Required	Base token information.
from.address	String	Required	Part of the from object. Sender address.
from.tx	String	Optional	Part of the from object. Sender hash.
from.tx_at	String	Optional	Part of the from object. Time of sender hash creation.
from.network_id	Number	Required	Part of the from object. Sender network relation.
from.token_id	Number	Required	Part of the from object. Sender token ID.
from.contract_address	String	Required	Part of the from object. Sender contract address.
from.decimals	Number	Required	Part of the from object. Sender token decimals to adjust amount.
from.amount	Decimals in string	Required	Part of the from object. Amount to swap.
to	Object	Required	Quote token information.
to.address	String	Required	Part of the to object. Receiver address.
to.tx	String	Optional	Part of the to object. Receiver hash.
to.tx_at	String	Optional	Part of the to object. Time of receiver hash creation.
to.network_id	Number	Required	Part of the to object. Network relation.
to.token_id	Number	Required	Part of the to object. Receiver token ID.
to.contract_address	String	Required	Part of the to object. Receiver contract address.
to.decimals	Number	Required	Part of the to object. Receiver token decimals to adjust amount.
to.min_amount	Decimals in string	Required	Part of the to object. Minimal quote amount expressed in basis points.
to.max_amount	Decimals in string	Required	Part of the to object. Maximum quote amount expressed in basis points.
to.amount_expected	Decimals in string	Required	Part of the to object. Expected minimal quote amount expressed in basis points.
to.amount	Decimals in string	Optional	Part of the to object. Receiver token amount expressed in basis points.
refund	Object	Required	Refund information.
refund.address	String	Optional	Part of the refund object. Address for potential refund.
refund.tx	String	Optional	Part of the refund object. Refund address hash.
refund.tx_at	String	Optional	Part of the refund object. Time of refund hash creation.
fees	Object	Optional	Applied fees for current quote.
fees.affiliate	Object	Optional	Part of the fees object. Affiliate fee information.
fees.affiliate.network_id	Number	Optional	Part of the fees.affiliate object. Affiliate network relation.
fees.affiliate.contract_address	String	Optional	Part of the fees.affiliate object. Affiliate token contract address.
fees.affiliate.token_id	Number	Optional	Part of the fees.affiliate object. Affiliate token ID.
fees.affiliate.decimals	Number	Optional	Part of the fees.affiliate object. Affiliate token decimals to adjust amount.
fees.affiliate.amount	Decimals in string	Optional	Part of the fees.affiliate object. Affiliate fee amount.
fees.affiliate.bps	String	Optional	Part of the fees.affiliate object. Affiliate amount of basis points.
deposit_address	String / Nullable	Required	Deposit address. Not null value only for deposit payin type.
created_at	Timestamp (microseconds)	Required	Swap intent creation time.

Sample response

application/json

{
  "intent_id": "fe5601fb-60f2-4cb0-8a67-c55bd3640411",
  "status": "Deposited",
  "from": {
    "amount": "10000000",
    "address": "0xbe7A42Af09*********8a88c8EE",
    "tx": "0x000000000000000000000000000000000000000",
    "tx_at": "2026-01-15T12:05:00Z",
    "network_id": 1,
    "token_id": 1,
    "contract_address": "0x000000000000000000000000000000000000000",
    "decimals": 6
  },
  "to": {
    "address": "0xac6B52Af09*********8a88c8EE",
    "tx": "1x000000000000000000000000000000000000000",
    "tx_at": "2026-01-15T12:05:00Z",
    "network_id": 2,
    "token_id": 4,
    "contract_address": "1x000000000000000000000000000000000000000",
    "decimals": 18,    
    "min_amount": "4230589541052713",
    "max_amount": "4251848784977602",
    "amount_expected": "4251848784977602"
  },
  "refund": {
    "address": "0xc02aaa39************083c756cc2",
    "tx": "0x000000000000000000000000000000000000000",
    "tx_at": "2026-01-15T12:05:00Z"
  },  
  "fees": {
    "affiliate": {
      "network_id": 1,
      "token_id": 78,
      "contract_address": "0xc02aaa39************083c756cc2",
      "bps": "25",
      "amount": "6000000000000",
      "decimals": 18
    }
  },
  "deposit_address": null,
  "created_at": 1778856025
}

---

Error response

Check the error response schema.

Error codes

Error code	Error type	Error description
401	authentication_error	Authentication error.
404	entity_not_found_error	Query swap intent not found.
404	http_error	Incorrect HTTP request.
500	internal_error	Internal server error.

401

{
  "code": 401,
  "type": "authentication_error",
  "message": "Authentication error"
}

404

Sample error response with the entity_not_found_error type

{
  "code": 404,
  "type": "entity_not_found_error",
  "message": "Entity not found"
}

Sample error response with the http_error type

{
  "code": 404,
  "type": "http_error",
  "message": "HTTP error"
}

500

{
  "code": 500,
  "type": "internal_error",
  "message": "Internal server error"
}

---