Taxation · Clients & orders

Create taxation client

Create a client. All personal and address fields are required.

POST request

URL: https://uat-api.vizodigital.com/api/v1/taxation/clients

Body

{
    "first_name": "Aman",
    "middle_name": "Kumar",
    "last_name": "Raj",
    "email": "aman@example.com",
    "phone": "9876543210",
    "pan": "ABCDE1234F",
    "aadhaar": "123412341234",
    "residence_address": "12 MG Road",
    "residence_city": "Patna",
    "residence_pincode": "800001",
    "residence_state": "Bihar",
    "office_address": "44 Exhibition Road",
    "office_city": "Patna",
    "office_pincode": "800001",
    "office_state": "Bihar",
    "client_request_id": "CLIENT_001"
}

Include a valid Bearer token with every request

Code sample

curl -X POST "https://uat-api.vizodigital.com/api/v1/taxation/clients" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "first_name": "Aman",
    "middle_name": "Kumar",
    "last_name": "Raj",
    "email": "aman@example.com",
    "phone": "9876543210",
    "pan": "ABCDE1234F",
    "aadhaar": "123412341234",
    "residence_address": "12 MG Road",
    "residence_city": "Patna",
    "residence_pincode": "800001",
    "residence_state": "Bihar",
    "office_address": "44 Exhibition Road",
    "office_city": "Patna",
    "office_pincode": "800001",
    "office_state": "Bihar",
    "client_request_id": "CLIENT_001"
}'

Success Response

{
    "status": "success",
    "message": "Client created successfully.",
    "data": {
        "client_id": 42,
        "first_name": "Aman",
        "middle_name": "Kumar",
        "last_name": "Raj",
        "email": "aman@example.com",
        "phone": "9876543210",
        "pan": "ABCDE1234F",
        "aadhaar": "123412341234",
        "residence_address": "12 MG Road",
        "residence_city": "Patna",
        "residence_pincode": "800001",
        "residence_state": "Bihar",
        "office_address": "44 Exhibition Road",
        "office_city": "Patna",
        "office_pincode": "800001",
        "office_state": "Bihar",
        "client_request_id": "CLIENT_001",
        "created_at": "2026-08-19T08:00:00+00:00"
    },
    "fee": 0,
    "wallet_balance": 10000
}

Failure response

{
    "status": "error",
    "message": "Request failed. Check credentials, wallet balance, or validation errors."
}

Overview

Creates a client record on the portal. Returns client_id — pass that into Create taxation order.

All fields from the Create Client form are required, including middle_name.

client_request_id is optional and must be unique per developer.

Body

application/json required

Create taxation client request body

Schema

{
    "type": "object",
    "required": [
        "first_name",
        "middle_name",
        "last_name",
        "email",
        "phone",
        "pan",
        "aadhaar",
        "residence_address",
        "residence_city",
        "residence_pincode",
        "residence_state",
        "office_address",
        "office_city",
        "office_pincode",
        "office_state"
    ],
    "properties": {
        "first_name": {
            "type": "string"
        },
        "middle_name": {
            "type": "string"
        },
        "last_name": {
            "type": "string"
        },
        "email": {
            "type": "string"
        },
        "phone": {
            "type": "string",
            "description": "10-digit mobile"
        },
        "pan": {
            "type": "string",
            "description": "ABCDE1234F"
        },
        "aadhaar": {
            "type": "string",
            "description": "12 digits"
        },
        "residence_address": {
            "type": "string"
        },
        "residence_city": {
            "type": "string"
        },
        "residence_pincode": {
            "type": "string"
        },
        "residence_state": {
            "type": "string"
        },
        "office_address": {
            "type": "string"
        },
        "office_city": {
            "type": "string"
        },
        "office_pincode": {
            "type": "string"
        },
        "office_state": {
            "type": "string"
        },
        "client_request_id": {
            "type": "string"
        }
    }
}

Example

{
    "first_name": "Aman",
    "middle_name": "Kumar",
    "last_name": "Raj",
    "email": "aman@example.com",
    "phone": "9876543210",
    "pan": "ABCDE1234F",
    "aadhaar": "123412341234",
    "residence_address": "12 MG Road",
    "residence_city": "Patna",
    "residence_pincode": "800001",
    "residence_state": "Bihar",
    "office_address": "44 Exhibition Road",
    "office_city": "Patna",
    "office_pincode": "800001",
    "office_state": "Bihar",
    "client_request_id": "CLIENT_001"
}

Responses

200 · application/json default

Successful response

Example

{
    "status": "success",
    "message": "Client created successfully.",
    "data": {
        "client_id": 42,
        "first_name": "Aman",
        "middle_name": "Kumar",
        "last_name": "Raj",
        "email": "aman@example.com",
        "phone": "9876543210",
        "pan": "ABCDE1234F",
        "aadhaar": "123412341234",
        "residence_address": "12 MG Road",
        "residence_city": "Patna",
        "residence_pincode": "800001",
        "residence_state": "Bihar",
        "office_address": "44 Exhibition Road",
        "office_city": "Patna",
        "office_pincode": "800001",
        "office_state": "Bihar",
        "client_request_id": "CLIENT_001",
        "created_at": "2026-08-19T08:00:00+00:00"
    },
    "fee": 0,
    "wallet_balance": 10000
}

Rate Limits

60/min