Make Your First API Call

Authentication Header

All API requests require your JWT token in the Authorization header using the Bearer scheme.

Format:

Authorization: Bearer YOUR_JWT_TOKEN

⚠️

Important: Use the JWT token from your email (generated in the previous step). Session IDs and other identifiers will not work.

Your First Request

Retrieve your integrator profile to verify authentication is configured correctly.

Endpoint:

GET /integrator/v1

cURL Example:

curl --request GET \
  --url https://staging-api.oneliquidity.technology/integrator/v1 \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'accept: application/json'

Implementation Steps:

1. Copy the cURL command above
2. Replace YOUR_JWT_TOKEN with your actual JWT token
3. Execute the command in your terminal
4. Verify you receive your integrator profile data

Expected Response

Successful requests return:

• HTTP Status: 200 OK
• Response Body: JSON object containing your profile details

Example Response:

{
  "message": "Integrator retrieved successfully",
  "data": {
    "email": "[email protected]",
    "businessName": "Your Business Name",
    "firstName": "John",
    "lastName": "Doe",
    "country": "NG",
    "active": true,
    "emailVerified": true,
    "services": [...],
    ...
  }
}

💡

Reference: For complete response schemas and interactive testing, see the API Reference.

Troubleshooting

401 Unauthorized

This error typically indicates:

• Invalid token: Verify you're using the complete JWT from your email
• Expired token: Generate a new token if the current one has expired
• Incorrect format: Ensure you're using Bearer YOUR_JWT_TOKEN format

Error Response:

{
    "status": false,
    "message": "Unauthorized: Invalid or expired token"
}

Resolution: Generate a new authentication token following the authentication guide.

Network Errors

If the request fails to connect:

• Verify base URL: https://staging-api.oneliquidity.technology
• Check network connectivity
• Ensure firewalls allow outbound API requests

Next Steps

Now that authentication is working, you can:

• Explore the API: Browse the complete API Reference
• Understand responses: Continue to the next section for response structures and error handling
• Build functionality: Start with wallet creation, balance queries, or transfer initiation

💡

API Reference Features: Each endpoint includes a "Try It!" button for browser-based testing with your authentication token.