Find Oracles by Category ID

Retrieves a paginated list of oracles associated with a specific category ID.

Request

GET /v2/admin/oracles/categories/{categoryID}

Parameters

Name	Type	In	Description
categoryID	string	path	Required. The ID of the category to retrieve oracles for
page	integer	query	Optional. Page number (default: 1)
per_page	integer	query	Optional. Number of items per page (default: 20)

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --location '{{baseUrl}}/v2/admin/oracles/categories/677ed6e3cc111aea14a3dfb4?page=1&per_page=20' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Response

{
    "data": [
        {
            "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"
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 20
}

Response Fields

Pagination Object

Field	Type	Description
data	array	Array of oracle objects
total	integer	Total number of items
page	integer	Current page number
per_page	integer	Number of items per page

Oracle Object

Field	Type	Description
id	string	Unique ID of the oracle
category_id	string	ID of the category this oracle belongs to
type	string	Type of the oracle (e.g., "TEFAS")
name	string	Name of the oracle
description	string	Description of the oracle
integration	object	Integration configuration object
integration.codes	array	Array of integration codes
integration.codes[].code	string	Integration code identifier
integration.codes[].name	string	Name associated with the integration code
created_at	string	Oracle creation timestamp (ISO 8601 format)
updated_at	string	Oracle last update timestamp (ISO 8601 format)

Status Codes

Status Code	Description
200	Success - Oracles retrieved successfully
400	Bad Request - Invalid category ID or query parameters
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Category does not exist
500	Internal Server Error