# सूची सेटिंग जाँचें

`GET /account/api/v1/residential/lists/{id}/check`

## प्राधिकरण

`Authorization: Bearer YOUR_ARNPROXY_API_KEY`

`Accept: application/json`

आवश्यक अनुमति: `residential_management`

## पैरामीटर

| नाम | प्रकार | आवश्यक / सशर्त | डिफ़ॉल्ट | विवरण |
|---|---|---|---|---|
| `id` (path) | integer | आवश्यक | — | इस कार्रवाई के अपने रिकॉर्ड की ID; 1–2147483647। दिखने वाला ऑर्डर नंबर या प्रदाता ID नहीं। |

## अनुरोध उदाहरण

### curl

```curl
printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    'https://www.arnproxy.com/account/api/v1/residential/lists/YOUR_LIST_ID/check'
```

### python

```python
import os, requests

headers = {"Authorization": "Bearer " + os.environ["ARNPROXY_API_KEY"]}
response = requests.get(
    "https://www.arnproxy.com/account/api/v1/residential/lists/YOUR_LIST_ID/check",
    headers=headers,
    timeout=(10, 30), allow_redirects=False
)
print(response.status_code, response.text)
# No automatic write retry.
```

### javascript

```javascript
const headers = { Authorization: `Bearer ${process.env.ARNPROXY_API_KEY}` };
const response = await fetch("https://www.arnproxy.com/account/api/v1/residential/lists/YOUR_LIST_ID/check", {
  method: 'GET', headers, redirect: 'error',
  signal: AbortSignal.timeout(30000)
});
console.log(response.status, await response.text());
// A write timeout is ambiguous; query its saved operation.
```

### php

```php
<?php
$headers = ['Accept: application/json',
    'Authorization: Bearer '.getenv('ARNPROXY_API_KEY')];
$ch = curl_init('https://www.arnproxy.com/account/api/v1/residential/lists/YOUR_LIST_ID/check');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 30,
]);
$result = curl_exec($ch);
if ($result === false) {
    // Do not repeat a write; use the original operation key.
    throw new RuntimeException('Transport result unknown');
}
echo curl_getinfo($ch, CURLINFO_HTTP_CODE).PHP_EOL.$result;
curl_close($ch);
```

### go

```go
package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
  "time"
)

func main() {
  client := &http.Client{Timeout: 30*time.Second,
    CheckRedirect: func(req *http.Request, via []*http.Request) error {
      return http.ErrUseLastResponse
    }}
  var body io.Reader
  req, err := http.NewRequest("GET", "https://www.arnproxy.com/account/api/v1/residential/lists/YOUR_LIST_ID/check", body)
  if err != nil { panic(err) }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("ARNPROXY_API_KEY"))
  res, err := client.Do(req); if err != nil { panic(err) }
  defer res.Body.Close()
  data, err := io.ReadAll(res.Body); if err != nil { panic(err) }
  fmt.Println(res.StatusCode, string(data))
}
```

### csharp

```csharp
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var handler = new HttpClientHandler { AllowAutoRedirect = false };
using var client = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(30) };
using var request = new HttpRequestMessage(HttpMethod.Get,
    "https://www.arnproxy.com/account/api/v1/residential/lists/YOUR_LIST_ID/check");
request.Headers.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("ARNPROXY_API_KEY"));
using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
// Never automatically retry an ambiguous write.
```

### java

```java
import java.net.URI;
import java.net.http.*;
import java.nio.charset.StandardCharsets;
import java.nio.file.*;

// Inside your application method:
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder(URI.create("https://www.arnproxy.com/account/api/v1/residential/lists/YOUR_LIST_ID/check"))
    .header("Authorization", "Bearer " + System.getenv("ARNPROXY_API_KEY"))
    .header("Accept", "application/json")
    .GET()
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
```

## उत्तर · HTTP 200

```json
{
  "ok": true,
  "data": {
    "tool": "ARN_RESIDENTIAL_LIST_CHECK_V1",
    "list_id": 30001,
    "read_only": true,
    "diagnostic": {
      "http_status": 200,
      "curl_errno": 0,
      "response_json": true,
      "provider_status": "success",
      "reason": "LIST_READ_VERIFIED",
      "api_version": "v2"
    },
    "elapsed_ms": 100,
    "read_timeout_seconds": 10,
    "data_shape": "array",
    "items_source": "data",
    "items_is_list": true,
    "items_count": 1,
    "matching_items": 1,
    "title_valid": true,
    "rotation_valid": true,
    "provider_get_attempts": 1,
    "provider_post_requests": 0,
    "database_changes": 0,
    "operation_journal_changes": 0,
    "raw_response_included": false,
    "customer_values_included": false,
    "secret_values_included": false
  },
  "meta": {
    "request_id": "000000000000000000000001",
    "phase": "public_v1",
    "source": "provider_read_diagnostic"
  }
}
```

| नाम | प्रकार | सशर्त | विवरण |
|---|---|---|---|
| `ok` | boolean | — | सफलता संकेत; false पर error.code देखें। |
| `data` | object | — | कार्रवाई-विशिष्ट परिणाम; उदाहरण कृत्रिम और समझाने के लिए हैं। |
| `data.tool` | string | — | tool का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.list_id` | integer | — | संबंधित ARNPROXY रिकॉर्ड ID; आंतरिक प्रदाता ID के बदले इसे लें। |
| `data.read_only` | boolean | — | read only का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.diagnostic` | object | — | diagnostic का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.diagnostic.http_status` | integer | — | http status का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.diagnostic.curl_errno` | integer | — | curl errno का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.diagnostic.response_json` | boolean | — | response json का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.diagnostic.provider_status` | string | — | provider status का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.diagnostic.reason` | string | — | निश्चित कारण कोड या null, मूल प्रदाता त्रुटि पाठ नहीं। |
| `data.diagnostic.api_version` | string | — | api version का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.elapsed_ms` | integer | — | elapsed ms का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.read_timeout_seconds` | integer | — | read timeout seconds का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.data_shape` | string | — | data shape का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.items_source` | string | — | items source का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.items_is_list` | boolean | — | items is list का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.items_count` | integer | — | items count का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.matching_items` | integer | — | matching items का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.title_valid` | boolean | — | title valid का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.rotation_valid` | boolean | — | rotation valid का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.provider_get_attempts` | integer | — | provider get attempts का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.provider_post_requests` | integer | — | provider post requests का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.database_changes` | integer | — | database changes का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.operation_journal_changes` | integer | — | operation journal changes का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.raw_response_included` | boolean | — | raw response included का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.customer_values_included` | boolean | — | customer values included का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.secret_values_included` | boolean | — | secret values included का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `meta` | object | — | अनुरोध संबद्धता और डेटा-स्रोत मेटाडेटा। |
| `meta.request_id` | string | — | इस HTTP अनुरोध की पहचान; कार्रवाई कुंजी या ऑर्डर ID नहीं। |
| `meta.phase` | string | — | phase का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `meta.source` | string | — | डेटा स्रोत; स्थानीय रिकॉर्ड और लाइव प्रदाता क्वेरी अलग प्रमाण हैं। |

## व्यवहार और महत्वपूर्ण नोट

- पैकेज/सूची ID ARNPROXY रिकॉर्ड ID हैं, प्रदाता कुंजियाँ नहीं। पुराना स्नैपशॉट पहुँच नहीं देता; ज़रूरत पर residential_package_refresh लें।
- नई सूची login_password या ip_auth लेती है। IP सूची में 1–20 अद्वितीय सार्वजनिक IPv4। सूची हटने से GB पैकेज नहीं हटता, केवल उस सूची के कनेक्शन बंद होते हैं।

प्रमाणीकरण और जाँच निष्पादन से पहले अनुरोध रोक सकते हैं। त्रुटि संदर्भ देखें और सहायता के लिए request_id रखें। कुंजी या पासवर्ड न भेजें।

[त्रुटियाँ और सीमाएँ](https://docs.arnproxy.com/hi/api-v1/errors)