---
title: "Timeframes.get"
method: GET
path: "/entities/Timeframes/{id}"
tags: ["Timeframe"]
---

# Timeframes.get

`GET /entities/Timeframes/{id}`

Returns Timeframe with given id

## Path parameters

- `id` string, uuid, required

## Response `200`

Timeframe data

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` Timeframe
    - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations.
    - `id` string, uuid, required — Unique identifier of entity.
    - `is_deleted` boolean — Specifies if the entity is considered deleted.
    - `modified` string, date-time — Last modification time.
    - `created` string, date-time — Creation time.
    - `lead` string, uri — Lead this step-time record belongs to. Set when lead_oppty_id resolves to a Lead. Relation to Lead. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Lead' object for properties.
    - `oppty` string, uri — Opportunity this step-time record belongs to. Set when lead_oppty_id resolves to an Opportunity. Relation to Opportunity. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Opportunity' object for properties.
    - `step` string, uri, required — Pipeline step the lead/opportunity entered. Relation to Step. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Step' object for properties.
    - `lead_oppty_id` string, uuid, required — Id of the lead or opportunity the timeframe belongs to.
    - `step_id` string, uuid, required — Id of the pipeline step.
    - `timeframe` integer, required — Number of seconds the record spent in the step (cumulative across re-entries).

## Other responses

- `404` — Sent when invalid ID is given
- `500` — unexpected error

---

[API](https://skmtc.net/aws/apis/pipeliner-cloud-api.md) · [All operations](https://skmtc.net/aws/apis/pipeliner-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pipeliner-cloud-api/revisions/e8c12ae60aca/schema)
