Admin API reference

PreviousAdmin API basics NextProduct Updates

post

This API uses basic authentication: To generate a token, make a request without a body while authorized with your old token auth.Token TTL time is 72 HRs.

Authorizations

Responses

application/json

objectOptional

application/json

post

POST /api/v1/account/login/refresh HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "token": "text"
}

List account rules

get

Authenticated IPs allow the use of Nimble pipelines without username or password in your proxy settings

Authorizations

Responses

application/json

objectOptional

application/json

get

GET /api/v1/account/authenticatedips HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "authorized_ips": [
    "text"
  ],
  "id": "text",
  "pipeline_rules": [
    {
      "pipeline_name": "text",
      "port_range_end": 1,
      "port_range_start": 1
    }
  ]
}

List all Pipelines

get

List all account pipelines

Authorizations

Responses

application/json

object[]Optional

application/json

get

GET /api/v1/account/pipelines HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "name": "text",
    "id": "text",
    "system_name": "text",
    "pipeline_type": "text",
    "proxy_pass": "text",
    "used_gb": 1,
    "spent_requests": 1,
    "created_at": "text",
    "updated_at": "text",
    "traffic": {
      "limit": {
        "amount": 1,
        "limit_type": "text"
      },
      "usage": {
        "bytes": 1,
        "last_reset_date": "text",
        "requests": 1,
        "usd": 1
      }
    },
    "allow_ipv6": true,
    "connection_string": "text",
    "optimization_engine": [
      "text"
    ],
    "pipeline_password": "text",
    "pipeline_username": "text",
    "proxy_server_address": "text",
    "proxy_server_port": 1,
    "session_settings": {
      "ip_rotation_type": "rotating",
      "rotation_time_in_seconds": 1,
      "session_ip_fallback": "replace_ip"
    },
    "status": "text",
    "target_locations": [
      {
        "country_code": "text",
        "state_code": "text",
        "city_code": "text"
      }
    ]
  }
]

Get a single Pipeline

get

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline Name

Responses

application/json

objectOptional

application/json

get

GET /api/v1/account/pipelines/{pipelineName} HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "name": "text",
  "id": "text",
  "system_name": "text",
  "pipeline_type": "text",
  "proxy_pass": "text",
  "used_gb": 1,
  "spent_requests": 1,
  "created_at": "text",
  "updated_at": "text",
  "traffic": {
    "limit": {
      "amount": 1,
      "limit_type": "text"
    },
    "usage": {
      "bytes": 1,
      "last_reset_date": "text",
      "requests": 1,
      "usd": 1
    }
  },
  "allow_ipv6": true,
  "connection_string": "text",
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_username": "text",
  "proxy_server_address": "text",
  "proxy_server_port": 1,
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

List pipeline rules

get

Authenticated IPs allow the use of Nimble pipelines without username or password in your proxy settings

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline name

Responses

application/json

objectOptional

application/json

get

GET /api/v1/account/pipelines/{pipelineName}/authenticatedips/portrange HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "pipeline_name": "text",
  "port_range_end": 1,
  "port_range_start": 1
}

Delete a rule

delete

Delete a pipeline port range rule

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline name

Responses

application/json

delete

DELETE /api/v1/account/pipelines/{pipelineName}/authenticatedips/portrange HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Change pipeline password

put

New password will be automatically generated for the Pipeline

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline Name

Responses

application/json

objectOptional

application/json

put

PUT /api/v1/account/pipelines/{pipelineName}/password HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "name": "text",
  "id": "text",
  "system_name": "text",
  "pipeline_type": "text",
  "proxy_pass": "text",
  "used_gb": 1,
  "spent_requests": 1,
  "created_at": "text",
  "updated_at": "text",
  "traffic": {
    "limit": {
      "amount": 1,
      "limit_type": "text"
    },
    "usage": {
      "bytes": 1,
      "last_reset_date": "text",
      "requests": 1,
      "usd": 1
    }
  },
  "allow_ipv6": true,
  "connection_string": "text",
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_username": "text",
  "proxy_server_address": "text",
  "proxy_server_port": 1,
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

Summary of daily Pipeline usage

get

Returns a daily summary of requests and response size (GB)

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline Name

Query parameters

fromDateanyOptional

From Date (DD/MM/YYYY)

toDateanyOptional

To Date (DD/MM/YYYY)

Responses

application/json

object[]Optional

application/json

get

GET /api/v1/account/pipelines/{pipelineName}/reports/daily-usage HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "daily_usages": [
      {
        "date": "text",
        "request_gb": 1,
        "response_gb": 1
      }
    ],
    "last_updated_at": "text",
    "total_request_gb": 1,
    "total_response_gb": 1
  }
]

Last 100 proxy requests made for specific pipeline

get

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline Name

Responses

application/json

object[]Optional

application/json

get

GET /api/v1/account/pipelines/{pipelineName}/reports/detailed-requests HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "account_name": "text",
    "client_ip": "text",
    "country_code": "text",
    "datetime": "text",
    "pipeline": "text",
    "request_host": "text",
    "request_port": 1,
    "request_size": 1,
    "response_size": 1,
    "total_size": 1,
    "type": "text"
  }
]

Deletes the pipelines quota daily limit

delete

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline Name

Responses

application/json

delete

DELETE /api/v1/account/pipelines/{pipelineName}/spendlimit HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Get account status

get

Authorizations

Responses

application/json

objectOptional

application/json

get

GET /api/v1/account/remaining-credits HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "billing": {
    "auto_renewal": true,
    "billing_period_end": "text",
    "billing_period_start": "text",
    "next_payment_date": "text",
    "payment_method": "text",
    "remaining_credits": 1,
    "roll_over": true,
    "spent_credits": 1,
    "subscription_services": [
      {
        "name": "ip",
        "spent_data_in_gb": 1,
        "spent_requests": 1
      }
    ]
  },
  "id": "text",
  "name": "text",
  "proxy_gateway_name": "text",
  "subscription_status": "text",
  "trials": {
    "activeTrials": [
      {
        "free_quota": 1,
        "free_used": 1,
        "name": "ip",
        "quota_type": "gigabytes",
        "status": "text",
        "trial_end": "text",
        "trial_start": "text"
      }
    ]
  }
}

Summary of daily account usage

get

Returns a daily summary of requests and response size (GB)

Authorizations

Query parameters

fromDateanyOptional

From Date (DD/MM/YYYY)

toDateanyOptional

To Date (DD/MM/YYYY)

Responses

application/json

object[]Optional

application/json

get

GET /api/v1/account/reports/daily-usage HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "daily_usages": [
      {
        "date": "text",
        "request_gb": 1,
        "response_gb": 1
      }
    ],
    "last_updated_at": "text",
    "total_request_gb": 1,
    "total_response_gb": 1
  }
]

Last 100 proxy requests made (entire Account)

get

Authorizations

Responses

application/json

object[]Optional

application/json

get

GET /api/v1/account/reports/detailed-requests HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "account_name": "text",
    "client_ip": "text",
    "country_code": "text",
    "datetime": "text",
    "pipeline": "text",
    "request_host": "text",
    "request_port": 1,
    "request_size": 1,
    "response_size": 1,
    "total_size": 1,
    "type": "text"
  }
]

Gets a custom timeout for a specific port

get

Gets a custom timeout for a specific port

Authorizations

Path parameters

portanyRequired

Port to query its timeout

Responses

application/json

get

GET /api/v1/account/timeout/{port} HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

No content

List of supported cities

get

Gets the list of supported cities in either JSON or HTML table. When using HTML table, addCountriesAndUsStates boolean can be used to add the rest of the supported countries and US states.

Authorizations

Query parameters

tableanyOptional

table

addCountriesAndUsStatesanyOptional

addCountriesAndUsStates

Responses

application/json

string[]Optional

application/json

get

GET /api/v1/location/cities HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

[
  "text"
]

post

This API uses JWT/Bearer authentication:

To generate a token, make a request with the following body/payload: { "username": "string", "password": "string" }

Apply the received token in your following API request, by adding the header: authorization: Bearer [token]

auth.Token TTL time is 72 HRs.

Body

usernamestringRequired

passwordstringRequired

Responses

application/json

objectOptional

application/json

post

POST /api/v1/account/login HTTP/1.1
Host: api.nimbleway.com
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "username": "text",
  "password": "text"
}

{
  "token": "text"
}

Create a rule

put

An authenticated IP can only be used with a single account. Authenticated IP will identify the target account in your proxy requests, replacing the need for using username or password

Authorizations

Body

ip_addressesstring[]Required

Responses

application/json

objectOptional

application/json

put

PUT /api/v1/account/authenticatedips HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "ip_addresses": [
    "text"
  ]
}

{
  "authorized_ips": [
    "text"
  ],
  "id": "text",
  "pipeline_rules": [
    {
      "pipeline_name": "text",
      "port_range_end": 1,
      "port_range_start": 1
    }
  ]
}

Delete a rule

delete

Delete an authenticated IP rule

Authorizations

Body

ip_addressstringRequired

Responses

application/json

delete

DELETE /api/v1/account/authenticatedips HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "ip_address": "text"
}

No content

Create a new Pipeline

post

Pipeline name - Use A-Z, a-z, 0-9 (can include space '.', '-', '_'). Up to 50 characters.
Target country - Default target country for the pipeline. Will apply to all request that do not specify a target country. Use ISO country code of 2-letter country code i.e. US, DE, BR.
Session settings configuration: When using rotating type, fallback is required in case a session_id is provided in order to set the behavior in case ip is not available When using fixed_interval type, rotation_time_in_seconds is required in order to set the interval of ip rotation and fallback is required as well for the same reason as above. replace_ip fallback will replace the session's ip to a new one and will keep using it as if it was selected in the first place. keep_asn fallback will find a new ip within the same asn and will keep using it as if it was selected in the first place. fail_request fallback will fail the request.

Authorizations

Body

namestring · min: 2 · max: 50Required

in swagger indicate wat's optional

allow_ipv6booleanOptional

Sets the default behavior of the project to allow the use of ipv6 from peers.

optimization_enginestring[] · max: 1Optional

pipeline_passwordstring · min: 8 · max: 12Optional

pipeline_typestring · enumRequiredAvailable options:

session_settingsall ofOptional

Sets the default behavior of the project's session

target_locationsobject[] · max: 1Optional

Use ALL in countryCode for no country limit

Responses

application/json

objectOptional

application/json

post

POST /api/v1/account/pipelines HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 311

{
  "name": "text",
  "allow_ipv6": true,
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_type": "ip",
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

{
  "name": "text",
  "id": "text",
  "system_name": "text",
  "pipeline_type": "text",
  "proxy_pass": "text",
  "used_gb": 1,
  "spent_requests": 1,
  "created_at": "text",
  "updated_at": "text",
  "traffic": {
    "limit": {
      "amount": 1,
      "limit_type": "text"
    },
    "usage": {
      "bytes": 1,
      "last_reset_date": "text",
      "requests": 1,
      "usd": 1
    }
  },
  "allow_ipv6": true,
  "connection_string": "text",
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_username": "text",
  "proxy_server_address": "text",
  "proxy_server_port": 1,
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

Update a pipeline

patch

Change pipeline's target country, session settings, Ipv6, project quota limit and status

Session settings configuration: When using rotating type, fallback is required in case a session_id is provided in order to set the behavior in case ip is not available When using fixed_interval type, rotation_time_in_seconds is required in order to set the interval of ip rotation and fallback is required as well for the same reason as above. replace_ip fallback will replace the session's ip to a new one and will keep using it as if it was selected in the first place. keep_asn fallback will find a new ip within the same asn and will keep using it as if it was selected in the first place. fail_request fallback will fail the request.

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline Name

Body

allow_ipv6booleanOptional

Sets the default behavior of the project to allow the use of ipv6 from peers.

optimization_enginestring[] · max: 1Optional

pipeline_passwordstring · min: 8 · max: 12Optional

session_settingsall ofOptional

Sets the default behavior of the project's session

statusstringOptional

target_locationsobject[] · max: 1Optional

Use ALL in countryCode for no country limit

Responses

application/json

objectOptional

application/json

patch

PATCH /api/v1/account/pipelines/{pipelineName} HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 292

{
  "allow_ipv6": true,
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

{
  "name": "text",
  "id": "text",
  "system_name": "text",
  "pipeline_type": "text",
  "proxy_pass": "text",
  "used_gb": 1,
  "spent_requests": 1,
  "created_at": "text",
  "updated_at": "text",
  "traffic": {
    "limit": {
      "amount": 1,
      "limit_type": "text"
    },
    "usage": {
      "bytes": 1,
      "last_reset_date": "text",
      "requests": 1,
      "usd": 1
    }
  },
  "allow_ipv6": true,
  "connection_string": "text",
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_username": "text",
  "proxy_server_address": "text",
  "proxy_server_port": 1,
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

Create a pipeline rule

put

An authenticated port range can only be used with a single pipeline. Authenticated port will identify the target pipeline in your proxy requests, replacing the need for using username or password

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline name

Body

port_range_endintegerRequired

port_range_startintegerRequired

Responses

application/json

objectOptional

application/json

put

PUT /api/v1/account/pipelines/{pipelineName}/authenticatedips/portrange HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "port_range_end": 1,
  "port_range_start": 1
}

{
  "authorized_ips": [
    "text"
  ],
  "id": "text",
  "pipeline_rules": [
    {
      "pipeline_name": "text",
      "port_range_end": 1,
      "port_range_start": 1
    }
  ]
}

Sets daily quota limit for a pipeline

post

Sets a daily limit to prevent pipeline from over spending. Two limit types are available:

"gb" for limiting the transferred data by GBs
"credit" for limiting the amount of used credits

Authorizations

Path parameters

pipelineNameanyRequired

Pipeline Name

Body

amountnumberOptional

typestringRequired

Responses

application/json

post

POST /api/v1/account/pipelines/{pipelineName}/spendlimit HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "amount": 1,
  "type": "text"
}

No content

Sets custom timeout to an allowed port

post

Sets custom timeout to an allowed port, to allow ports contact Nimble admin (the value can range between 10 and 30 seconds)
Port must be allowed in order to set a custom timeout

Authorizations

Body

portintegerRequired

timeout_in_secsinteger · min: 10 · max: 30Required

Responses

application/json

post

POST /api/v1/account/timeout HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "port": 1,
  "timeout_in_secs": 1
}

No content

Removes custom timeout to an allowed port

delete

Removes custom timeout to an allowed port

Authorizations

Body

portintegerRequired

Responses

application/json

delete

DELETE /api/v1/account/timeout HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 10

{
  "port": 1
}

No content

Admin API reference

Admin API reference

INTRODUCTION

Authentication

Authenticated IPs

Pipelines

Account Status

Global Preferences

Location

INTRODUCTION

Authentication

Authenticated IPs

Pipelines

Account Status

Global Preferences

Location

List account rules

List all Pipelines

Get a single Pipeline

List pipeline rules

Delete a rule

Change pipeline password

Summary of daily Pipeline usage

Last 100 proxy requests made for specific pipeline

Deletes the pipelines quota daily limit

Get account status

Summary of daily account usage

Last 100 proxy requests made (entire Account)

Gets a custom timeout for a specific port

List of supported cities

Create a rule

Delete a rule

Create a new Pipeline

Update a pipeline

Create a pipeline rule

Sets daily quota limit for a pipeline

Sets custom timeout to an allowed port

Removes custom timeout to an allowed port

INTRODUCTION

Authentication

Authenticated IPs

Pipelines

Account Status

Global Preferences

Location

INTRODUCTION

Authentication

Authenticated IPs

Pipelines

Account Status

Global Preferences

Location

Get new authentication token

List account rules

List all Pipelines

Get a single Pipeline

List pipeline rules

Delete a rule

Change pipeline password

Summary of daily Pipeline usage

Last 100 proxy requests made for specific pipeline

Deletes the pipelines quota daily limit

Get account status

Summary of daily account usage

Last 100 proxy requests made (entire Account)

Gets a custom timeout for a specific port

List of supported cities

Get authentication token

Create a rule

Delete a rule

Create a new Pipeline

Update a pipeline

Create a pipeline rule

Sets daily quota limit for a pipeline

Sets custom timeout to an allowed port

Removes custom timeout to an allowed port