1. IP Orders
Nstdata Resell Service API
  • Nstdata Resell API
    • Zones
      • Get service zone list
    • Channels
      • Get channel usage statistics
      • Get total usage for all service channels
      • Create channel
      • Batch query channels
      • Batch query channel usage summary
      • Get channel detail
      • Update channel
      • Delete channel
    • IP Products
      • Get service IP product list
    • IP Orders
      • Get total purchased IP quantity
        GET
      • Batch query IP orders
        POST
      • Buy service IPs
        POST
      • Get purchased IP order detail
        GET
      • Renew IP order
        POST
    • Regions
      • Get country list
    • Proxies
      • Generate proxies
    • Schemas
      • SuccessResponse
      • ErrorResponse
      • ProxyType
      • RegionProxyType
      • IpOrderType
      • ProxyProtocol
      • Zone
      • Channel
      • CreateChannelRequest
      • UpdateChannelRequest
      • ChannelIdsRequest
      • ChannelUsageRequest
      • ChannelStatistics
      • UsageMetric
      • ChannelUsageTotal
      • ChannelUsageSummary
      • IpProduct
      • PurchaseTotalByType
      • PurchaseTotal
      • OrderIdsRequest
      • IpProxyItem
      • IpOrder
      • IpOrderDetail
      • CreateIpOrderProduct
      • CreateIpOrderRequest
      • ErrorProxyItem
      • CreateIpOrderResponse
      • RenewSuccessItem
      • RenewIpOrderResponse
      • Country
      • GenerateProxiesResponse
  • Cloud Browser Developer API
    • Automation Access
      • Get CDP Credentials for an Existing Session
    • Session Configuration
      • Get Available Options
      • Estimate Browser Runtime Cost
    • Session Management
      • Create Browser Session
      • List Browser Sessions
      • Get Session Details and Status
      • Rename Browser Session
      • Stop Browser Session
    • Connection Credentials
      • Get Live View Credentials
    • Configuration Details
      • Get Session Configuration
    • Usage and Costs
      • Get Session Usage and Costs
      • Get Costs for Multiple Sessions
      • Get All Session Statistics
      • Get Historical Session Statistics
    • Schemas
      • BrowserConnectionResponseDto
      • BrowserOptionsResponseDto
      • BrowserErrorDto
      • SharedStorageErrorDto
      • SharedHttpErrorDto
      • BrowserEstimateDto
      • BrowserQuoteResponseDto
      • CreateBrowserDto
      • BrowserSessionResponseDto
      • BrowserListResponseDto
      • RenameBrowserDto
      • BrowserNameResponseDto
      • BrowserLiveViewResponseDto
      • BrowserConfigurationResponseDto
      • BrowserCostsResponseDto
      • BrowserCostsBatchDto
      • BrowserCostsBatchResponseDto
      • BrowserStatisticsResponseDto
      • BrowserHistoryStatisticsResponseDto
      • BrowserOptionsDto
      • BrowserQuoteDto
      • BrowserExtensionDto
      • BrowserCaptchaSettingsDto
      • BrowserFingerprintDto
      • BrowserSessionDto
      • BrowserListDto
      • BrowserNameDto
      • BrowserConnectionDto
      • BrowserLiveViewDto
      • BrowserConfigurationDto
      • BrowserCostsDto
      • BrowserCostsBatchDataDto
      • BrowserStatisticsDto
      • BrowserHistoryStatisticsDto
      • BrowserScreenOptionsDto
      • BrowserRecordingOptionsDto
      • BrowserFingerprintPresetDto
      • BrowserProxyCountryOptionDto
      • BrowserResourceClassOptionDto
      • BrowserCaptchaTypesDto
      • BrowserResolutionOptionDto
      • BrowserRecordingAvailabilityDto
      • BrowserProviderObservationDto
      • BrowserCaptchaPublicDto
      • BrowserEffectiveConfigurationDto
      • BrowserRequestedConfigurationDto
      • BrowserResolvedConfigurationDto
      • BrowserRuntimeCostDto
      • BrowserProxyCostDto
      • BrowserCaptchaCostDto
      • BrowserScreenRangeDto
      • BrowserNetworkIdentityDto
      • BrowserEffectiveExtensionDto
      • BrowserEffectiveFingerprintDto
      • BrowserConfigurationExtensionDto
      • BrowserResolvedFingerprintDto
      • BrowserIpAlignmentDto
  1. IP Orders

Get purchased IP order detail

GET
/api/v1/service/purchase/ip/{orderId}

Order status (data.status)#

ValueNameMeaning
0IdleNot activated; not a payment or purchase-failure status.
1ActivatedThe order is activated.
2ExpiredThe order has expired and cannot be renewed. Purchase a new order.
3DeletedThe order has been soft-deleted. This endpoint excludes deleted orders and returns an error for them.
This endpoint can return non-deleted orders with status 0, 1, or 2. Check expireAt as well as status: expiration status updates are asynchronous. For an individual proxy, use its own proxies[].expireAt when supplied.
For bulk queries, POST /api/v1/service/ip/query returns activated orders only (status 1). An omitted order in a bulk response must not be interpreted as a specific lifecycle status.
Order status is different from channel status: order status 3 means Deleted, while channel status 3 means Banned.

Response example provenance#

Examples were generated through local testing on 2026-09-15 using synthetic, nonfunctional test values for identifiers, proxy addresses and credentials. They illustrate the response format and are not production response captures. Amounts, stock and dates are illustrative, not live quotations or availability.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Responses

🟢200
application/json
Success
Bodyapplication/json

🟠400BadRequestError
🟠401UnauthorizedError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/service/purchase/ip/' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Order detail — verified test data
Examples were generated through local testing on 2026-09-15 using synthetic, nonfunctional test values for identifiers, proxy addresses and credentials. They illustrate the response format and are not production response captures. Amounts, stock and dates are illustrative, not live quotations or availability. GET /api/v1/service/purchase/ip/22222222-2222-4222-8222-222222222222. The detail response uses quantity and does not include number. The response shows a user-owned order (ownerType 0); identifiers are test placeholders.
{
    "data": {
        "userId": "user_example_001",
        "ownerType": 0,
        "ownerId": "user_example_001",
        "createdBy": "user_example_001",
        "updatedBy": "user_example_001",
        "orderId": "22222222-2222-4222-8222-222222222222",
        "name": "Example ISP Order",
        "type": "ISP",
        "status": 1,
        "createdByServiceId": "service_example_001",
        "totalPrice": 6,
        "discount": 1,
        "period": 30,
        "expireAt": "2026-10-15T02:00:00.000Z",
        "createdAt": "2026-09-15T02:00:00.000Z",
        "updatedAt": "2026-09-15T02:00:00.000Z",
        "unitPrice": 3,
        "quantity": 2,
        "proxies": [
            {
                "subOrderId": "11111111-1111-4111-8111-111111111111",
                "productId": "product_example_us_001",
                "basePrice": 3,
                "region": "US",
                "city": "New York",
                "scene": "general",
                "proxy": "192.0.2.10:8000:exampleuser:ExamplePass001",
                "expireAt": "2026-10-15T02:00:00.000Z"
            },
            {
                "subOrderId": "11111111-1111-4111-8111-111111111111",
                "productId": "product_example_us_001",
                "basePrice": 3,
                "region": "US",
                "city": "New York",
                "scene": "general",
                "proxy": "192.0.2.11:8000:exampleuser:ExamplePass001",
                "expireAt": "2026-10-15T02:00:00.000Z"
            }
        ]
    },
    "err": false,
    "msg": "SUCCESS",
    "code": 200
}
Modified at 2026-09-15 08:22:49
Previous
Buy service IPs
Next
Renew IP order
Built with