Endpoints

GET

profile

Get organization profile

curl --request GET \
  --url https://serviceapi.sarafa.ss/v3/profile \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://serviceapi.sarafa.ss/v3/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://serviceapi.sarafa.ss/v3/profile"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "status": "success",
  "data": {
    "organization": {
      "name": "Acme Ltd",
      "description": "Merchant account",
      "slug": "acme",
      "logo_url": null,
      "website_url": "https://example.com"
    },
    "account_number": "9020260000001"
  }
}

Use the API playground below to test the authenticated profile endpoint. The generated endpoint pages in this section let you test every Merchant API endpoint from the OpenAPI reference.

Authentication

Send your API key in the x-api-key header on every request. Use environment: sandbox while testing. If the environment header is omitted, the request uses production.

Endpoints covered

GET /v3/profile
GET /v3/wallets
GET /v3/wallet/{currency}
POST /v3/collect
POST /v3/transfer
POST /v3/swap
GET /v3/transactions
GET /v3/transaction/{id}
GET /v3/rates

Error codes

Code	Meaning
`400`	Invalid request data, unsupported currency, unsupported pair, or invalid phone number.
`401`	Missing or invalid API key.
`403`	Merchant profile or account context could not be resolved.
`404`	Requested wallet or resource was not found.
`409`	`external_reference` already exists.
`500`	The request could not be processed.

Authorizations

x-api-key

string

header

required

Merchant API secret.

Headers

environment

enum<string>

default:production

Target environment. Defaults to production when omitted.

Available options:

production,

sandbox

Response

Organization profile.

status

enum<string>

required

Available options:

success

data

object

required

Show child attributes

Last modified on July 7, 2026

Rate limits

Get organization profile

curl --request GET \
  --url https://serviceapi.sarafa.ss/v3/profile \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://serviceapi.sarafa.ss/v3/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://serviceapi.sarafa.ss/v3/profile"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "status": "success",
  "data": {
    "organization": {
      "name": "Acme Ltd",
      "description": "Merchant account",
      "slug": "acme",
      "logo_url": null,
      "website_url": "https://example.com"
    },
    "account_number": "9020260000001"
  }
}

Get started

How to use the API

Endpoint playground

Authentication

Endpoints covered

Error codes

Authorizations

Headers

Response

​Authentication

​Endpoints covered

​Error codes

Authorizations

Headers

Response

Authentication

Endpoints covered

Error codes