Skip to main content

Find Oracle by ID

Retrieves detailed information about an oracle with the specified ID.

Request

GET /v2/admin/oracles/{oracleID}

Parameters

NameTypeInDescription
oracleIDstringpathRequired. The ID of the oracle to retrieve details for

Headers

NameDescription
AuthorizationRequired. Bearer token for authentication

Example

curl --location '{{baseUrl}}/v2/admin/oracles/677ed6e3cc111aea14a3dfc3' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Response

{
"id": "677ed6e3cc111aea14a3dfc3",
"category_id": "677ed6e3cc111aea14a3dfb4",
"type": "TEFAS",
"name": "Gümüş Fonu",
"description": "TEFAS Gümüş Fonu",
"integration": {
"codes": [
{
"code": "IOG",
"name": "Gümüş Fonu"
},
{
"code": "GTZ",
"name": "Gümüş Fonu"
}
]
},
"created_at": "2024-01-01T00:00:00Z",
"updated_at": "2024-01-01T00:00:00Z"
}

Response Fields

FieldTypeDescription
idstringUnique ID of the oracle
category_idstringID of the category this oracle belongs to
typestringType of the oracle (e.g., "TEFAS")
namestringName of the oracle
descriptionstringDescription of the oracle
integrationobjectIntegration configuration object
integration.codesarrayArray of integration codes
integration.codes[].codestringIntegration code identifier
integration.codes[].namestringName associated with the integration code
created_atstringOracle creation timestamp (ISO 8601 format)
updated_atstringOracle last update timestamp (ISO 8601 format)

Status Codes

Status CodeDescription
200Success - Oracle details retrieved successfully
400Bad Request - Invalid oracle ID
401Unauthorized - Invalid or missing authentication token
404Not Found - Oracle does not exist
500Internal Server Error