List developers with published projects

GET

/companies

const url = 'https://agent-dev.azizdubai.com/companies';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://agent-dev.azizdubai.com/companies \
  --header 'X-API-Key: <X-API-Key>'

Returns developer companies (company_type = 3) that own at least one published project. Intended for populating the “Developer” filter dropdown.

Authorizations

apiKeyHeader
bearerKey

Responses

200

List of developers.

application/json

object

status

required

string

Allowed value: success

data

required

The shape depends on the operation.

data

required

object

items

Array<object>

object

integer

name

string

logo

Ready-to-use logo link, built from STATIC_BASE_URL.

string | null

Example

{
  "status": "success"
}

401

The key is missing (missing api key) or invalid (invalid api key). The latter covers unknown, revoked and deleted keys. Every operation requires a key, so any request without one receives this response.

application/json

object

status

required

string

Allowed value: error

message

required

Human-readable message.

string

Examples

invalid

{
  "status": "error",
  "message": "invalid api key"
}

403

The key is valid, but it is restricted to a list of domains and the request’s Origin (or Referer) does not match any of them; or the key’s agency has no approved licence.

application/json

object

status

required

string

Allowed value: error

message

required

Human-readable message.

string

Examples

{
  "status": "error",
  "message": "origin is not allowed for this api key"
}

{
  "status": "error",
  "message": "agency license is required: upload a company license and wait for its approval"
}

500

An unexpected error. The cause is logged; a generic message is returned.

application/json

object

status

required

string

Allowed value: error

message

required

Human-readable message.

string

Examples

generic

{
  "status": "error",
  "message": "internal server error"
}