Authentication

The GitImsi API uses API keys to authenticate requests. You can manage your API keys from the Dashboard.

Base URL: https://api.gitimsi.com/v1

API Key Authentication

Include your API key in the Authorization header of every request:

Header	Value	Required
`Authorization`	`Bearer YOUR_API_KEY`	Required
`Content-Type`	`application/json`	Required
`X-Request-ID`	`Unique request identifier`	Optional

Status Codes

Code	Meaning
`200`	Success
`201`	Created
`400`	Bad Request
`401`	Unauthorized
`429`	Rate Limited
`500`	Internal Server Error

GET

/proxies

Returns a list of all proxies in your account with their current status, region, and configuration.

Query Parameters

Parameter	Type	Description
`region`	string	Filter by region (us, eu, asia)
`status`	string	Filter by status (active, rotating, static)
`limit`	integer	Max results (default: 50, max: 200)
`offset`	integer	Pagination offset

Response Schema

JSON Response
{
  "data": [
    {
      "id": "proxy_abc123",
      "ip": "203.0.113.42",
      "port": 8080,
      "region": "us-east-1",
      "status": "active",
      "type": "residential",
      "latency_ms": 45
    }
  ],
  "total": 2450,
  "limit": 50,
  "offset": 0
}

Quick Start

Get up and running with the GitImsi API in under 5 minutes. Install our SDK, configure your API key, and make your first request.

1. Install the SDK

bash
npm install @gitimsi/sdk
# or
pip install gitimsi

2. Initialize

JavaScript
import { GitImsi } from '@gitimsi/sdk';

const client = new GitImsi({
  apiKey: 'your_api_key_here'
});

// List your proxies
const proxies = await client.proxies.list();
console.log(proxies);

Rate Limits

API rate limits depend on your plan tier. Rate limit headers are included in every response.

Plan	Requests/min	Requests/day
Starter	60	10,000
Growth	300	100,000
Scale	1,000	1,000,000
Enterprise	Custom	Unlimited

curl -X GET \
  https://api.gitimsi.com/v1/proxies \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json'

import requests

response = requests.get(
    'https://api.gitimsi.com/v1/proxies',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY'
    }
)
proxies = response.json()

const response = await fetch(
  'https://api.gitimsi.com/v1/proxies',
  {
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    }
  }
);
const data = await response.json();

package main

import (
    "net/http"
    "fmt"
)

func main() {
    req, _ := http.NewRequest(
        "GET",
        "https://api.gitimsi.com/v1/proxies",
        nil,
    )
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    client := &http.Client{}
    resp, _ := client.Do(req)
    fmt.Println(resp.Status)
}

Response

{
  "data": [
    {
      "id": "proxy_abc123",
      "ip": "203.0.113.42",
      "status": "active"
    }
  ],
  "total": 2450
}