Get Oracle Metric

Returns one metric provider with its connection. The auth secret is never returned: integration.connection.auth.secret_set only says whether one is stored. A deleted provider is not found.

Required permission: oracle:view

Request

GET /v2/admin/oracle-metrics/{oracle_metric_id}

Parameters

Name	Type	In	Description
oracle_metric_id	string	path	Required. Metric provider id (24-character hex)

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/oracle-metrics/6a5d0206379ebd02e53bf1a1' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "id": "6a5d0206379ebd02e53bf1a1",
  "category_id": "6a5d0206379ebd02e53bf0df",
  "type": "SHEET",
  "name": "Togg Şarj İstasyonu Metric Sheet",
  "description": "Google Sheets üzerinden yönetilen Togg şarj istasyonu token metrikleri",
  "integration": {
    "codes": [
      { "code": "TOGG1", "name": "Togg Şarj İstasyonu 1", "description": "İstanbul Ataşehir hızlı şarj istasyonu" },
      { "code": "TOGG2", "name": "Togg Şarj İstasyonu 2", "description": "Ankara Çankaya hızlı şarj istasyonu" }
    ],
    "fiat_currency": "TRY",
    "connection": {
      "url": "https://docs.google.com/spreadsheets/d/1Q9xWmT4kLp7RzV2sN8bYc3HdF6gJ0aEu5iO/export?format=csv&gid=0",
      "timeout": 30,
      "cache_ttl_seconds": 300,
      "auth": {
        "type": "NONE",
        "name": "",
        "username": "",
        "secret_set": false
      },
      "headers": []
    }
  },
  "created_at": "2026-07-19T16:57:42.876Z",
  "updated_at": "2026-07-19T16:57:42.876Z"
}

Response Fields

Field	Type	Description
id	string	Metric provider id
category_id	string	Category the provider belongs to
type	string	Source type: TOGG or SHEET (a published spreadsheet). There is no TEFAS metric provider
name	string	Provider name
description	string	Description
integration	object	Source configuration
integration.codes	array	The series this provider can read, each addressed by its code
integration.codes[].code	string	Code the source knows the series by
integration.codes[].name	string	Display name of the series
integration.codes[].description	string	Description of the series. Omitted when not set
integration.fiat_currency	string	ISO 4217 code of the currency the source's rental income is in (e.g. TRY)
integration.connection	object	Where the provider reads from
integration.connection.url	string	Base URL of the source
integration.connection.timeout	integer	Request timeout in seconds. 0 means the default (30)
integration.connection.cache_ttl_seconds	integer	How long a fetched source document is reused within one server process. 0 disables this cache
integration.connection.auth.type	string	NONE, BEARER, API_KEY, BASIC or QUERY_PARAM
integration.connection.auth.name	string	Header (API_KEY) or query parameter (QUERY_PARAM) the secret travels in
integration.connection.auth.username	string	Username (BASIC only)
integration.connection.auth.secret_set	boolean	Whether a secret is stored. The secret itself is never returned
integration.connection.headers	array	Static headers sent with every request, returned in clear text
integration.connection.headers[].name	string	Header name
integration.connection.headers[].value	string	Header value
created_at	string	Creation time (ISO 8601)
updated_at	string	Last update time (ISO 8601)

Errors

Status	Code	Description
400	10000	oracle_metric_id is not a valid 24-character hex id (this endpoint reports a malformed id with the generic code, not 10016)
400	10001	Metric provider not found or deleted (domain 53)

See Errors for the error format and common codes.