Orders

Options like product_id, location_id, and more can be retrieved using the Products endpoint.

Products

Get Orders

GET /orders

Query Parameters

Name	Type	Description	Available options
product_id	Integer	Product id
page	Integer	Number of page
per_page	Integer	Number of orders to get per page
location_id	Integer	Location id
status	String	Order status	unpaid in-progress confirmed refunded expired
note_search	String	Phrases in order's note field to search by
order_ids	Array	Order ids to get

Example response:

{
    "data": [
        {
            "id": 420,
            "note": null,
            "product_name": "Static Residential",
            "plan_name": "30 Days",
            "expire_date": "2024-04-20 10:25:12",
            "status": "confirmed",
            "location": "United States",
            "quantity": 5,
            "questions_answers": [
                {
                    "question": "Extra requirements (if you have any):",
                    "answer": "I need 128.158.97"
                }
            ],
            "proxy_data": {
                "ports": {
                    "socks5": 12324,
                    "http|https": 12323
                },
                "proxies": []
            },
            "auto_extend_settings": null,
            "extended_history": []
        },
        ...
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 2,
        "path": "https://apid.iproyal.com/v1/reseller/orders",
        "per_page": 10,
        "to": 10,
        "total": 14
    }
}

Get Order

GET /orders/{order_id}

Example response:

{
    "id": 420,
    "note": null,
    "product_name": "Static Residential",
    "plan_name": "30 Days",
    "expire_date": "2024-04-20 10:25:12",
    "status": "expired",
    "location": "Canada",
    "quantity": 5,
    "questions_answers": [],
    "proxy_data": {
        "ports": {
            "socks5": 12324,
            "http|https": 12323
        },
        "proxies": []
    },
    "auto_extend_settings": null,
    "extended_history": []
}

Calculate Pricing

GET /orders/calculate-pricing

Query Parameters

Name	Type	Description
product_id	Integer	Product id
product_plan_id	Integer	Product plan id
product_location_id	Integer	Product location id
quantity	Integer	Proxy quantity
coupon_code	String	Coupon code

Example response:

{
    "pre_discount_price": 30,
    "price_with_vat": 30,
    "vat": null,
    "price": 30,
    "pre_discount_price_per_item": 3,
    "price_per_item": 3,
    "plan_discount_percent": 0,
    "location_discount_percent": 0,
    "coupon_discount_percent": 0,
    "quantity_discount_percent": 0,
    "total_discount_percent": 0,
    "quantity_required_for_next_discount": {
        "quantity": 90,
        "discount": 5
    },
    "message": null
}

Create Order

POST /orders

Body Parameters

Name	Type	Description
product_id	Integer	Product id
product_plan_id	Integer	Product plan id
product_location_id	Integer	Product location id
quantity	Integer	Proxy quantity
coupon_code	String	Coupon code
auto_extend	Boolean	Should the order be extended automatically
product_question_answers	Array	Answers to questions { question_id: answer, ... }

Example response:

{
    "id": 420,
    "note": null,
    "product_name": "Static Residential",
    "plan_name": "30 Days",
    "expire_date": "2024-04-20 10:25:12",
    "status": "expired",
    "location": "Canada",
    "quantity": 5,
    "questions_answers": [],
    "proxy_data": {
        "ports": {
            "socks5": 12324,
            "http|https": 12323
        },
        "proxies": []
    },
    "auto_extend_settings": null,
    "extended_history": []
}

Extend Order

POST /orders/{order_id}/extend

Body Parameters

Name	Type	Description
product_plan_id	Integer	Product plan id

Example response:

{
    "id": 420,
    "note": null,
    "product_name": "Static Residential",
    "plan_name": "30 Days",
    "expire_date": "2024-04-20 10:25:12",
    "status": "expired",
    "location": "Canada",
    "quantity": 5,
    "questions_answers": [],
    "proxy_data": {
        "ports": {
            "socks5": 12324,
            "http|https": 12323
        },
        "proxies": []
    },
    "auto_extend_settings": null,
    "extended_history": []
}