Get Sell Status

Check the status of a Sell transaction.

Retrieves the current status of a Sell (fiat payout) transaction.

Endpoint

GET /v1/sell/status

Authentication

Header

Value

x-api-key

Your API key

Query parameters

Parameter

Type

Required

Description

reference

string

Yes

Your unique transaction reference

Example request

curl -X GET "https://ramp-api.ivorypay.io/api/v1/sell/status?reference=880e8400-e29b-41d4-a716-446655440003" \
  -H "x-api-key: your_api_key"

const response = await fetch(
  "https://ramp-api.ivorypay.io/api/v1/sell/status?reference=880e8400-e29b-41d4-a716-446655440003",
  {
    method: "GET",
    headers: {
      "x-api-key": "your_api_key",
    },
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://ramp-api.ivorypay.io/api/v1/sell/status",
    headers={
        "x-api-key": "your_api_key",
    },
    params={
        "reference": "880e8400-e29b-41d4-a716-446655440003",
    },
)

print(response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://ramp-api.ivorypay.io/api/v1/sell/status?reference=880e8400-e29b-41d4-a716-446655440003", nil)
	req.Header.Set("x-api-key", "your_api_key")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Example response

{
  "statusCode": 200,
  "success": true,
  "message": "Query successful",
  "data": {
    "reference": "880e8400-e29b-41d4-a716-446655440003",
    "status": "SUCCESS",
    "fiatAmount": 75000,
    "currency": "NGN",
    "accountNumber": "0123456789",
    "accountName": "Tunde Bakare",
    "bankName": "GTBank",
    "createdAt": "2026-03-26T12:00:00.000Z"
  }
}

Transaction statuses

Status

Description

INITIATED

Payout created

PROCESSING

Bank transfer in progress

SUCCESS

Fiat delivered to bank account

FAILED

Payout failed

CANCELLED

Payout was cancelled

PreviousInitiate Sell NextList All Banks

Last updated 1 month ago

hashtagEndpoint

hashtagAuthentication

hashtagQuery parameters

hashtagExample request

hashtagExample response