---
title: "Get report REST API | HitKeep"
description: "Reference for the HitKeep REST API operation Get report, including request parameters, responses, and authentication notes."
canonical: "https://hitkeep.com/api/operations/apireportsreport_id/get/"
---

# Get report REST API

GET

/api/reports/{report_id}

FetchcURL

```
const url = 'http://127.0.0.1:25737/api/reports/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'GET', headers: {cookie: 'hk_token=<hk_token>'}};

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

```
curl --request GET \
  --url http://127.0.0.1:25737/api/reports/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --cookie hk_token=<hk_token>
```

-

Returns one report visible to the authenticated user.

## Authorizations

- **[cookieAuth](https://hitkeep.com/api/#cookieauth)**

## Parameters

### Path Parameters

**report_id**

required

string format: uuid

Report definition UUID.

## Responses

### 200

Report

application/json

object

**consent_version**

integer

>= 1

**created_at**

required

string format: date-time

**created_by**

string format: uuid

**id**

required

string format: uuid

**last_outcome**

object

***key***

additional properties

any

**name**

required

string

**next_run_at**

string format: date-time

**owner_user_id**

string format: uuid

**preset**

required

string

Allowed values: site_summary portfolio_digest opportunity_brief

**recipients**

required

Array<object>

object

**confirmation_expires_at**

string format: date-time

**confirmed_at**

string format: date-time

**email**

required

string format: email

**id**

required

string format: uuid

**invitation_state**

string

Allowed values: pending sent failed

**kind**

required

string

Allowed values: member external

**opted_out_at**

string format: date-time

**status**

required

string

Allowed values: pending_confirmation confirmed opted_out

**user_id**

string format: uuid

**schedule**

required

object

**frequency**

required

string

Allowed values: daily weekly monthly

**local_time**

required

string

/^([01][0-9]|2[0-3]):(00|15|30|45)$/

**monthly_day**

integer

>= 1 <= 28

**timezone**

required

IANA timezone name.

string

**weekly_day**

integer

<= 6

**scope**

required

string

Allowed values: personal team

**site_mode**

required

string

Allowed values: selected all_accessible

**sites**

required

Array<object>

object

**domain**

string

**id**

string format: uuid

**source**

required

string

Allowed values: v2 legacy

**status**

required

string

Allowed values: draft active paused

**tenant_id**

string format: uuid

**updated_at**

required

string format: date-time

##### Example

```
{
  "preset": "site_summary",
  "recipients": [
    {
      "invitation_state": "pending",
      "kind": "member",
      "status": "pending_confirmation"
    }
  ],
  "schedule": {
    "frequency": "daily"
  },
  "scope": "personal",
  "site_mode": "selected",
  "source": "v2",
  "status": "draft"
}
```

### 404

Not found

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

[Previous One-click unsubscribe](https://hitkeep.com/api/operations/apireportsunsubscribeopaque_token/post/)[Next Delete report](https://hitkeep.com/api/operations/apireportsreport_id/delete/)