> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.feedonomics.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.feedonomics.com/_mcp/server.

# Retrieves a single database

GET https://meta.feedonomics.com/api.php/dbs/{db_id}

Reference: https://docs.feedonomics.com/developer/api-reference/rest/platform-api/database/retrieves-a-single-database

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `db_id` (double, required)

### Headers

- `x-api-key` (string, required)

## Response

### 200

Get single DB

- `id` (string, optional)
- `name` (string, optional)
- `category_field_offset` (string, optional)
- `user_id` (string, optional)
- `account_id` (string, optional)
- `import_running` (string, optional)
- `export_running` (string, optional)
- `paused` (string, optional)
- `visibility` (string, optional)
- `oauth_id` (string, optional)
- `email_address` (string, optional)
- `google_account_id` (string, optional)
- `google_account_name` (string, optional)
- `google_analytics_oauth_id` (string, optional)
- `google_analytics_profile_id` (string, optional)
- `amazon_seller_id` (string, optional)
- `amazon_marketplace_id` (string, optional)
- `amazon_mws_auth_token` (string, optional)
- `bing_oauth_id` (string, optional)
- `bing_shopping_account_id` (string, optional)
- `bing_shopping_campaign_id` (string, optional)
- `polyvore_username` (string, optional)
- `polyvore_password` (string, optional)
- `polyvore_campaign_id` (string, optional)
- `external_id` (string, optional)
- `time` (string, optional)
- `feedonomics_auth_token` (string, optional)
- `manual_billing_exclusion` (string, optional)
- `google_merchant_center_oauth_id` (string, optional)
- `google_merchant_center_account_id` (string, optional)
- `google_my_business_oauth_id` (string, optional)
- `timestamp` (string, optional)
- `billing_parent_id` (string, optional)
- `sears_email` (string, optional)
- `sears_seller_id` (string, optional)
- `sears_secret_key` (string, optional)
- `walmart_private_key` (string, optional)
- `walmart_consumer_id` (string, optional)
- `kijiji_oauth_id` (string, optional)
- `mercado_libre_client_id` (string, optional)
- `mercado_libre_client_secret` (string, optional)
- `mercado_libre_oauth_id` (string, optional)
- `mercado_libre_country` (string, optional)
- `google_sheets_oauth_id` (string, optional)
- `shopify_oauth_id` (string, optional)
- `facebook_oauth_id` (string, optional)
- `facebook_page_id` (string, optional)
- `facebook_cms_id` (string, optional)
- `character_set` (string, optional)
- `host` (string, optional)
- `scheduler_host` (string, optional)
- `feed_report_host` (string, optional)
- `cxn_id` (string, optional)
- `run_import_id` (string, optional)
- `data_count` (string, optional)
- `google_service_account_id` (string, optional)
- `woocommerce_oauth_id` (string, optional)
- `bigcommerce_oauth_id` (string, optional)
- `empty_exports_on_data_refresh_failures` (string, optional)
- `last_run_imports_status` (string, optional)
- `etsy_oauth_id` (string, optional)
- `wish_oauth_id` (string, optional)
- `db_service` (string, optional)
- `created_at` (string, optional)
- `deleted_at` (string, optional)
- `mirakl_oauth_id` (string, optional)
- `run_import_stats` (string, optional)
- `run_import_duration` (string, optional)
- `features` (DbsDbIdGetResponsesContentApplicationJsonSchemaFeatures, optional)
- `db_group_id` (integer, optional)
- `default_db_group_id` (integer, optional)

## Types

### DbsDbIdGetResponsesContentApplicationJsonSchemaFeatures

## Examples

**Response**

```json
{
  "id": "1",
  "name": "db one",
  "user_id": "74",
  "account_id": "73",
  "import_running": "0",
  "export_running": "0",
  "paused": "0",
  "visibility": "1",
  "oauth_id": "0",
  "email_address": "",
  "google_account_id": "",
  "google_account_name": "",
  "google_analytics_oauth_id": "0",
  "google_analytics_profile_id": "",
  "amazon_seller_id": "",
  "amazon_marketplace_id": "",
  "amazon_mws_auth_token": "",
  "bing_oauth_id": "0",
  "bing_shopping_account_id": "",
  "bing_shopping_campaign_id": "",
  "polyvore_username": "",
  "polyvore_password": "",
  "polyvore_campaign_id": "",
  "external_id": "",
  "time": "2021-09-16 17:46:47",
  "feedonomics_auth_token": "cce3ddc6fbcf2ea7d4d3931c8d8821af4dcb666d401cdce643c699d4beb76895",
  "manual_billing_exclusion": "0",
  "google_merchant_center_oauth_id": "",
  "google_merchant_center_account_id": "",
  "google_my_business_oauth_id": "",
  "timestamp": "2021-09-16 17:48:21",
  "billing_parent_id": "0",
  "sears_email": "",
  "sears_seller_id": "",
  "sears_secret_key": "",
  "walmart_private_key": "",
  "walmart_consumer_id": "",
  "kijiji_oauth_id": "0",
  "mercado_libre_client_id": "",
  "mercado_libre_client_secret": "",
  "mercado_libre_oauth_id": "0",
  "mercado_libre_country": "",
  "google_sheets_oauth_id": "0",
  "shopify_oauth_id": "0",
  "facebook_oauth_id": "0",
  "facebook_page_id": "",
  "facebook_cms_id": "",
  "character_set": "utf8",
  "host": "127.0.0.1",
  "scheduler_host": "localhost",
  "feed_report_host": "127.0.0.1",
  "cxn_id": "301",
  "run_import_id": "6b75de51ce790807",
  "data_count": "14139",
  "google_service_account_id": "0",
  "woocommerce_oauth_id": "0",
  "bigcommerce_oauth_id": "0",
  "empty_exports_on_data_refresh_failures": "0",
  "last_run_imports_status": "success",
  "etsy_oauth_id": "0",
  "wish_oauth_id": "0",
  "created_at": "2021-09-16 17:46:47",
  "deleted_at": "0000-00-00 00:00:00",
  "features": [],
  "db_group_id": 0,
  "default_db_group_id": 0,
  "paused_at": "0000-00-00 00:00:00"
}
```

**SDK Code**

```python Database_retrievesASingleDatabase_example
import requests

url = "https://meta.feedonomics.com/api.php/dbs/1.1"

headers = {
    "x-api-key": "x-api-key",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Database_retrievesASingleDatabase_example
const url = 'https://meta.feedonomics.com/api.php/dbs/1.1';
const options = {
  method: 'GET',
  headers: {'x-api-key': 'x-api-key', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Database_retrievesASingleDatabase_example
package main

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

func main() {

	url := "https://meta.feedonomics.com/api.php/dbs/1.1"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "x-api-key")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Database_retrievesASingleDatabase_example
require 'uri'
require 'net/http'

url = URI("https://meta.feedonomics.com/api.php/dbs/1.1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = 'x-api-key'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Database_retrievesASingleDatabase_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://meta.feedonomics.com/api.php/dbs/1.1")
  .header("x-api-key", "x-api-key")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Database_retrievesASingleDatabase_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://meta.feedonomics.com/api.php/dbs/1.1', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'x-api-key' => 'x-api-key',
  ],
]);

echo $response->getBody();
```

```csharp Database_retrievesASingleDatabase_example
using RestSharp;

var client = new RestClient("https://meta.feedonomics.com/api.php/dbs/1.1");
var request = new RestRequest(Method.GET);
request.AddHeader("x-api-key", "x-api-key");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Database_retrievesASingleDatabase_example
import Foundation

let headers = [
  "x-api-key": "x-api-key",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://meta.feedonomics.com/api.php/dbs/1.1")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```