Accounts

📘 TAAS API Reference

Base URL:

http://127.0.0.1:8000/api/v1/taas/

Authentication:

• All endpoints require an API-KEY header.

---

🔐 Authentication

Header

API-KEY: <your-api-key>

---

👤 Account APIs

---

1. Create Account

Endpoint

POST /register/

Description

Creates a new TAAS account with KYC details.

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/register/' \
--header 'Content-Type: application/json' \
--header 'API-KEY: <API_KEY>' \
--data-raw '{
    "email": "[email protected]",
    "phone_number": 8158805277,
    "first_name": "Naimish",
    "last_name": "Sanghvi",
    "user_ip_address": "103.186.68.169",
    "annual_income": "< ₹5 Lakhs",
    "is_email_verified": true,
    "is_mobile_number_verified": true,
    "country": "IN",
    "gender": "male",
    "occupation": "Private Job",
    "is_politicaly_exposed_person": false,
    "dob": "21/03/2000",
    "device_id": "Samsung 11"
}'

---

Response

{
  "id": 116,
  "reference_id": "bb6gjdtgkt",
  "kyc_status": "pending",
  "country": "IN",
  "phone_number": "8158805277",
  "user": {
    "id": 150,
    "email": "[email protected]",
    "first_name": "Naimish",
    "last_name": "Sanghvi"
  },
  "aml_status": "pending",
  "created_at": 1772787515.35161,
  "banks": [],
  "kyc_verified_at": null,
  "gender": "male",
  "dob": "2000-03-21",
  "occupation": "Private Job",
  "annual_income": "< ₹5 Lakhs",
  "is_politicaly_exposed_person": false,
  "is_email_verified": true,
  "is_mobile_number_verified": true
}

---

Enums

Annual Income

< ₹5 Lakhs
₹5 Lakhs-₹10 Lakhs
₹10 Lakhs-₹25 Lakhs
₹25 Lakhs-₹50 Lakhs
₹50 Lakhs-1 Crore
>₹1 Crore

Occupation

Private Job
Goverment Job
Business Owner
Home Maker
Freelancer
Unemployed
Student
Professional

Gender

male
female
other

---

2. Get Account Details

Endpoint

GET /account/{id}/

Description

Fetch details of a specific account.

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/account/114/' \
--header 'API-KEY: <API_KEY>'

---

Response

{
  "id": 114,
  "reference_id": "bb6gjdtgkt",
  "kyc_status": "pending",
  "country": "IN",
  "phone_number": "8158805277",
  "user": {
    "id": 147,
    "email": "[email protected]",
    "first_name": "Naimish",
    "last_name": "Sanghvi"
  },
  "aml_status": "pending",
  "created_at": 1772786870.051443,
  "banks": [],
  "kyc_verified_at": null,
  "gender": "male",
  "dob": null,
  "occupation": "Private Job",
  "annual_income": "< ₹5 Lakhs",
  "is_politicaly_exposed_person": false,
  "is_email_verified": false,
  "is_mobile_number_verified": false
}

---

3. Get All Accounts

Endpoint

GET /accounts/

Description

Fetch a paginated list of accounts with optional filters.

---

Query Params

Param	Description
kyc_status	Filter by KYC status
aml_status	Filter by AML status

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/accounts/?kyc_status=verified&aml_status=verified' \
--header 'API-KEY: <API_KEY>'

---

Response

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 6,
      "kyc_status": "verified",
      "aml_status": "verified"
    }
  ]
}

(Trimmed for brevity — full structure includes user + banks)

---

4. Update Account

Endpoint

PATCH /account/{id}/

Description

Update account details partially.

---

Request

curl --location --request PATCH 'http://127.0.0.1:8000/api/v1/taas/account/114/' \
--header 'Content-Type: application/json' \
--header 'API-KEY: <API_KEY>' \
--data '{
    "country": "IN",
    "phone_number": "[phone]",
    "is_mobile_number_verified": true,
    "user": {
        "first_name": "John",
        "last_name": "Doe 3333"
    },
    "annual_income": "₹5 Lakhs-₹10 Lakhs"
}'

---

Response

{
  "id": 114,
  "phone_number": "[phone]",
  "user": {
    "first_name": "John",
    "last_name": "Doe 3333"
  },
  "annual_income": "₹5 Lakhs-₹10 Lakhs"
}

---

5. Get Main Account

Endpoint

GET /main_account/

Description

Fetch the primary (main) account with wallet balances.

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/main_account/' \
--header 'API-KEY: <API_KEY>'

---

Response

{
    "id": 2,
    "reference_id": "bb6gjdtgkt",
    "is_main": true,
    "kyc_status": "pending",
    "aml_status": "pending",
    "country": "IN",
    "phone_number": null,
    "user": {
        "id": 4,
        "email": "[email protected]",
        "first_name": "",
        "last_name": ""
    },
    "created_at": "2025-11-10T15:40:39+05:30",
    "kyc_verified_at": null,
    "banks": [],
    "wallets": [
        {
            "asset": "INR",
            "current_balance": "99160.0000000000",
            "sip_locked_balance": "0E-10"
        },
        {
            "asset": "USDT",
            "current_balance": "99908.5855348111",
            "sip_locked_balance": "0E-10"
        }
    ]
}

---