---
title: "Best Practice | Endpoint Introspection"
slug: "best-practice-endpoint-introspection"
updated: 2024-10-18T13:34:16Z
published: 2024-10-18T13:34:16Z
canonical: "developers.cmicglobal.com/best-practice-endpoint-introspection"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Best Practice | Endpoint Introspection

## Using /describe

Adding "/describe" is a helpful way to extract essential information about a specific endpoint. For instance, if one takes the endpoint "/hcm-rest-api/rest/1/pyemployee," appending "/describe" to it as "/hcm-rest-api/rest/1/pyemployee/describe" will provide the following details:

![328937a-small-Capture2.PNG](https://cdn.document360.io/fb2f8da1-4f36-47a5-aa2b-f649dbc152cd/Images/Documentation/328937a-small-Capture2.PNG)

### ?fields filter

This section lists all the attributes of the endpoint along with their data type, whether they can be updated or queried, and if they are mandatory or optional fields.

![aa0d025-small-Capture3.PNG](https://cdn.document360.io/fb2f8da1-4f36-47a5-aa2b-f649dbc152cd/Images/Documentation/aa0d025-small-Capture3.PNG)

### ?finder filter

Here the output shows all the available finders for the specific endpoint, including the name of the finder and the queryable fields. Additionally, it specifies if the fields are optional or not.

![f351a7a-small-Capture4.PNG](https://cdn.document360.io/fb2f8da1-4f36-47a5-aa2b-f649dbc152cd/Images/Documentation/f351a7a-small-Capture4.PNG){height="" width=""} . For the finder shown in the above image ("findByDate"), there are two optional fields that one could query on. Below shows one example:

![1b5485c-small-Capture5.PNG](https://cdn.document360.io/fb2f8da1-4f36-47a5-aa2b-f649dbc152cd/Images/Documentation/1b5485c-small-Capture5.PNG)

### ?primary key filter

This section lists the primary key which identifies each unique record in the database.

![608f47d-small-Capture.PNG](https://cdn.document360.io/fb2f8da1-4f36-47a5-aa2b-f649dbc152cd/Images/Documentation/608f47d-small-Capture.PNG)

### Information on available actions

All enabled actions on this endpoint (GET, POST, PATCH, DELETE) are available.

![6a5b4c7-small-Capture.PNG](https://cdn.document360.io/fb2f8da1-4f36-47a5-aa2b-f649dbc152cd/Images/Documentation/6a5b4c7-small-Capture.PNG)

## /version lookup

          
          

Each CMiC endpoint roll up into a container. The containers mimic CMiC product applications.

The containers mimic CMiC product applications. Here is how to lookup version on file by resource container.

To validate the container version installed on the CMiC APi Server instance, append the endpoint name with /version

Here is an example, let's say we want to check the version for this URL

```
https://{add CMiC domain}/{add CMiC server}/hcm-rest-api/rest/1/pyemployee
```

In the example above the container is represented by **hcm-rest-api/rest/1** and the endpoint is **/pyemployee**.

To check the version on this endpoint, remove the /pyemployee and replace with /version, then run the GET method to retrieve the version installed.

#### Request

```
https://{add CMiC domain}/{add CMiC server}/hcm-rest-api/rest/1/version
```

#### Response

```
{
    "items": [
        {
            "Version": "1.0.160292",
            "links": [
                {
                    "rel": "self",
                    "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/version/1.0.160292",
                    "name": "version",
                    "kind": "item"
                },
                {
                    "rel": "canonical",
                    "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/version/1.0.160292",
                    "name": "version",
                    "kind": "item"
                }
            ]
        }
    ],
    "count": 1,
    "hasMore": false,
    "limit": 5,
    "offset": 0,
    "links": [
        {
            "rel": "self",
            "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/version",
            "name": "version",
            "kind": "collection"
        }
    ]
}
```