Get application - Cognite Docs

GET

api

orgs

{org}

applications

{clientId}

Get application

curl --request GET \
  --url https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}

const options = {method: 'GET'};

fetch('https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}")

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

request = Net::HTTP::Get.new(url)

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

{
  "id": "f4a3e291-7682-4148-89c0-be3a8f17eb23",
  "name": "My Data Portal",
  "allowedOrigins": [
    "https://*.example.com"
  ],
  "projectNames": [
    "publicdata"
  ],
  "createdTime": 1730204346000,
  "lastUpdatedTime": 1730204346000,
  "description": "Customer-facing data portal for project ACME-PROD."
}

{
  "error": {
    "code": 401,
    "message": "Could not authenticate.",
    "missing": [
      {}
    ],
    "duplicated": [
      {}
    ]
  }
}

{
  "error": {
    "code": 401,
    "message": "Could not authenticate.",
    "missing": [
      {}
    ],
    "duplicated": [
      {}
    ]
  }
}

{
  "error": {
    "code": 401,
    "message": "Could not authenticate.",
    "missing": [
      {}
    ],
    "duplicated": [
      {}
    ]
  }
}

Path Parameters

org

string

required

ID of an organization The ID of an organization

Required string length: 3 - 64

Pattern: ^([a-z][a-z0-9-]{1,62}[a-z0-9])$

Example:

"my-org"

clientId

string

required

ID of an application Unique identifier of an application.

Example:

"f4a3e291-7682-4148-89c0-be3a8f17eb23"

Response

An application.

An application registered for an organization. Can be connected to any number of CDF projects, including zero, one, or multiple.

string

required

Unique identifier of an application.

Example:

"f4a3e291-7682-4148-89c0-be3a8f17eb23"

name

string

required

Human-readable name of the application.

Required string length: 1 - 50

Example:

"My Data Portal"

allowedOrigins

string[]

required

Origins permitted to make cross-origin requests to the CDF API for the connected projects. Each entry is an origin in the form scheme://host[:port].

A pattern may contain one or more wildcards (*), each matching any sequence of characters within a single domain label. A wildcard may not appear in the registrable label (the label directly in front of the public suffix, e.g. com or co.uk) or in the port.

For example, https://*.example.com is valid, since the wildcard is in a subdomain label. https://*.com and https://*.co.uk are not valid, since the wildcard is in the registrable label, immediately in front of the public suffix.

Maximum 30 origins per application.

Maximum array length: 30

projectNames

string[]

required

The CDF project names this application is connected to.

The URL name of the project. This is used as part of the request path in API calls.

Valid URL names contains between 3 and 32 characters, and may only contain English letters, digits and hyphens, must contain at least one letter and may not start or end with a hyphen.

Required string length: 3 - 32

createdTime

integer<int64>

required

The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.

Required range: x >= 0

Example:

1730204346000

lastUpdatedTime

integer<int64>

required

The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.

Required range: x >= 0

Example:

1730204346000

description

string

Optional description of the application.

Maximum string length: 500

Example:

"Customer-facing data portal for project ACME-PROD."

Last modified on October 7, 2026

⌘I

Get application

curl --request GET \
  --url https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}

const options = {method: 'GET'};

fetch('https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://auth.cognite.com/api/v1/orgs/{org}/applications/{clientId}")

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

request = Net::HTTP::Get.new(url)

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

{
  "id": "f4a3e291-7682-4148-89c0-be3a8f17eb23",
  "name": "My Data Portal",
  "allowedOrigins": [
    "https://*.example.com"
  ],
  "projectNames": [
    "publicdata"
  ],
  "createdTime": 1730204346000,
  "lastUpdatedTime": 1730204346000,
  "description": "Customer-facing data portal for project ACME-PROD."
}

{
  "error": {
    "code": 401,
    "message": "Could not authenticate.",
    "missing": [
      {}
    ],
    "duplicated": [
      {}
    ]
  }
}

{
  "error": {
    "code": 401,
    "message": "Could not authenticate.",
    "missing": [
      {}
    ],
    "duplicated": [
      {}
    ]
  }
}

{
  "error": {
    "code": 401,
    "message": "Could not authenticate.",
    "missing": [
      {}
    ],
    "duplicated": [
      {}
    ]
  }
}