Time Tracker

Postman collection → OpenAPI spec →

Introduction

This is the Time Tracker App API Documentation

Base URL: https://time-tracker-backend.pinnguaq.com

This documentation aims to provide all the information you need to work with our API.

Authenticating requests

This API is not authenticated.

Activity

Get All

GET

https://time-tracker-backend.pinnguaq.com

/api/user/activities

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

paginate

boolean

Field to paginate. Defaults to true.

Example:

page

integer

Field to paginate. Defaults to null.

Example:

perPage

integer

Field to paginate. Defaults to null.

Example:

filterBy

string

Field to filterBy. Defaults to null.

Example:

name

filterValue

string

Field to filterValue. Defaults to null.

Example:

Car

Example request:

curl --request GET \
    --get "https://time-tracker-backend.pinnguaq.com/api/user/activities?paginate=1&page=1&perPage=1&filterBy=name&filterValue=Car" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "success": true,
    "status_code": 200,
    "message": [
        "Record fetched successfully."
    ],
    "data": {
        "list": [
            {
                "id": 3,
                "name": "Doe",
                "created_at": "2024-03-04T08:46:33.000000Z",
                "updated_at": "2024-03-04T08:46:33.000000Z"
            },
            {
                "id": 2,
                "name": "Jane",
                "created_at": "2024-03-04T08:46:33.000000Z",
                "updated_at": "2024-03-04T08:46:33.000000Z"
            },
            {
                "id": 1,
                "name": "John",
                "created_at": "2024-03-04T08:46:33.000000Z",
                "updated_at": "2024-03-04T08:46:33.000000Z"
            }
        ],
        "pagination": {
            "total": 3,
            "per_page": 10,
            "current": 1,
            "first": 1,
            "last": 1,
            "previous": null,
            "next": null,
            "pages": [
                1
            ],
            "from": 1,
            "to": 3
        }
    }
}

Auth

APIs for managing Auth

POST

https://time-tracker-backend.pinnguaq.com

/api/user/login

Headers

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

firebase_token

string

The firebase token field is required.

Example:

username

string

This field is required when firebase_token is not present.

password

string

This field is required when firebase_token is not present.

Example request:

curl --request POST \
    "https://time-tracker-backend.pinnguaq.com/api/user/login" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"firebase_token\": \"ea\"
}"

Refresh

POST

https://time-tracker-backend.pinnguaq.com

/api/user/refresh

Exchanges an existing (possibly expired-but-within-refresh-window) JWT for a new one. Public — the endpoint reads the current token from the Authorization header so the access-token expiry middleware can't reject us first.

Headers

Content-Type

Example:

application/json

Example:

application/json

Example request:

curl --request POST \
    "https://time-tracker-backend.pinnguaq.com/api/user/refresh" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Logout

POST

https://time-tracker-backend.pinnguaq.com

/api/user/logout

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Example request:

curl --request POST \
    "https://time-tracker-backend.pinnguaq.com/api/user/logout" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Get Profile

GET

https://time-tracker-backend.pinnguaq.com

/api/user/profile

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Example request:

curl --request GET \
    --get "https://time-tracker-backend.pinnguaq.com/api/user/profile" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    vary
                                                            : Origin

{
    "success": false,
    "status": 401,
    "message": [
        "You are not authenticated. Please login."
    ],
    "data": []
}

Update Profile

PUT

PATCH

https://time-tracker-backend.pinnguaq.com

/api/user/profile/update

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

first_name

string

required

The firstname of the user. Must not be greater than 255 characters.

Example:

wpqgmarfqjdjzpcxx

last_name

string

required

Must not be greater than 255 characters.

Example:

cazghofuzxemhetebq

phone

string

Must not be greater than 255 characters.

Example:

xlelcfzffleymee

password

string

Must be at least 8 characters.

Example:

\W2q_,cet/=,lp

picture

string

Must be a valid URL.

Example:

http://www.tillman.com/assumenda-omnis-officiis-dolor-pariatur-tenetur-doloribus-vitae-perferendis.html

province

string

Must be one of:

AB
BC
MB
NB
NL
NS
NT
NU
ON
PE
QC
SK
YT

Example:

Example request:

curl --request PUT \
    "https://time-tracker-backend.pinnguaq.com/api/user/profile/update" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"first_name\": \"wpqgmarfqjdjzpcxx\",
    \"last_name\": \"cazghofuzxemhetebq\",
    \"phone\": \"xlelcfzffleymee\",
    \"password\": \"\\\\W2q_,cet\\/=,lp\",
    \"picture\": \"http:\\/\\/www.tillman.com\\/assumenda-omnis-officiis-dolor-pariatur-tenetur-doloribus-vitae-perferendis.html\",
    \"province\": \"NU\"
}"

Delete Profile

DELETE

https://time-tracker-backend.pinnguaq.com

/api/user/profile

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Example request:

curl --request DELETE \
    "https://time-tracker-backend.pinnguaq.com/api/user/profile" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

Capability

Get All

GET

https://time-tracker-backend.pinnguaq.com

/api/user/capabilities

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

paginate

boolean

Field to paginate. Defaults to true.

Example:

page

integer

Field to paginate. Defaults to null.

Example:

perPage

integer

Field to paginate. Defaults to null.

Example:

filterBy

string

Field to filterBy. Defaults to null.

Example:

name

filterValue

string

Field to filterValue. Defaults to null.

Example:

Car

Example request:

curl --request GET \
    --get "https://time-tracker-backend.pinnguaq.com/api/user/capabilities?paginate=1&page=1&perPage=1&filterBy=name&filterValue=Car" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "success": true,
    "status_code": 200,
    "message": [
        "Record fetched successfully."
    ],
    "data": {
        "list": [
            {
                "id": 3,
                "name": "Doe",
                "created_at": "2024-03-04T08:46:13.000000Z",
                "updated_at": "2024-03-04T08:46:13.000000Z"
            },
            {
                "id": 2,
                "name": "Jane",
                "created_at": "2024-03-04T08:46:13.000000Z",
                "updated_at": "2024-03-04T08:46:13.000000Z"
            },
            {
                "id": 1,
                "name": "John",
                "created_at": "2024-03-04T08:46:13.000000Z",
                "updated_at": "2024-03-04T08:46:13.000000Z"
            }
        ],
        "pagination": {
            "total": 3,
            "per_page": 10,
            "current": 1,
            "first": 1,
            "last": 1,
            "previous": null,
            "next": null,
            "pages": [
                1
            ],
            "from": 1,
            "to": 3
        }
    }
}

Division

Get All

GET

https://time-tracker-backend.pinnguaq.com

/api/user/divisions

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

paginate

boolean

Field to paginate. Defaults to true.

Example:

page

integer

Field to paginate. Defaults to null.

Example:

perPage

integer

Field to paginate. Defaults to null.

Example:

filterBy

string

Field to filterBy. Defaults to null.

Example:

name

filterValue

string

Field to filterValue. Defaults to null.

Example:

Car

Example request:

curl --request GET \
    --get "https://time-tracker-backend.pinnguaq.com/api/user/divisions?paginate=1&page=1&perPage=1&filterBy=name&filterValue=Car" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "success": true,
    "status_code": 200,
    "message": [
        "Record fetched successfully."
    ],
    "data": [
        {
            "id": 3,
            "name": "Doe",
            "created_at": "2024-02-28T15:43:48.000000Z",
            "updated_at": "2024-02-28T15:43:48.000000Z"
        },
        {
            "id": 2,
            "name": "Jane",
            "created_at": "2024-02-28T15:43:48.000000Z",
            "updated_at": "2024-02-28T15:43:48.000000Z"
        },
        {
            "id": 1,
            "name": "John",
            "created_at": "2024-02-28T15:43:48.000000Z",
            "updated_at": "2024-02-28T15:43:48.000000Z"
        }
    ]
}

Project

Get All

GET

https://time-tracker-backend.pinnguaq.com

/api/user/projects

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

paginate

boolean

Field to paginate. Defaults to true.

Example:

page

integer

Field to paginate. Defaults to null.

Example:

perPage

integer

Field to paginate. Defaults to null.

Example:

filterBy

string

Field to filterBy. Defaults to null.

Example:

name

filterValue

string

Field to filterValue. Defaults to null.

Example:

Car

Example request:

curl --request GET \
    --get "https://time-tracker-backend.pinnguaq.com/api/user/projects?paginate=1&page=1&perPage=1&filterBy=name&filterValue=Car" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "success": true,
    "status_code": 200,
    "message": [
        "Record fetched successfully."
    ],
    "data": {
        "list": [
            {
                "id": 3,
                "project_no": "34545",
                "name": "Doe",
                "created_at": "2024-03-04T08:49:22.000000Z",
                "updated_at": "2024-03-04T08:49:22.000000Z"
            },
            {
                "id": 2,
                "project_no": "23555",
                "name": "Jane",
                "created_at": "2024-03-04T08:49:22.000000Z",
                "updated_at": "2024-03-04T08:49:22.000000Z"
            },
            {
                "id": 1,
                "project_no": "14345",
                "name": "John",
                "created_at": "2024-03-04T08:49:22.000000Z",
                "updated_at": "2024-03-04T08:49:22.000000Z"
            }
        ],
        "pagination": {
            "total": 3,
            "per_page": 10,
            "current": 1,
            "first": 1,
            "last": 1,
            "previous": null,
            "next": null,
            "pages": [
                1
            ],
            "from": 1,
            "to": 3
        }
    }
}

TimeCardTemplate

Stop pre-filling new cards. Idempotent.

DELETE

https://time-tracker-backend.pinnguaq.com

/api/user/time-card-templates/default

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Example request:

curl --request DELETE \
    "https://time-tracker-backend.pinnguaq.com/api/user/time-card-templates/default" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Make this template the one pre-filled onto every new card.

PUT

https://time-tracker-backend.pinnguaq.com

/api/user/time-card-templates/{time_card_template}/default

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

time_card_template

string

required

Example:

dolores

Example request:

curl --request PUT \
    "https://time-tracker-backend.pinnguaq.com/api/user/time-card-templates/dolores/default" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

List the caller's templates.

GET

https://time-tracker-backend.pinnguaq.com

/api/user/time-card-templates

requires authentication

Never paginated: MAX_PER_USER caps the list well below a page, and the app applies templates from a local cache of this exact payload.

Headers

Content-Type

Example:

application/json

Example:

application/json

Example request:

curl --request GET \
    --get "https://time-tracker-backend.pinnguaq.com/api/user/time-card-templates" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    vary
                                                            : Origin

{
    "success": false,
    "status": 401,
    "message": [
        "You are not authenticated. Please login."
    ],
    "data": []
}

Create a template.

POST

https://time-tracker-backend.pinnguaq.com

/api/user/time-card-templates

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

name

string

required

Must not be greater than 60 characters.

Example:

fesceooyy

division_id

integer

required

Example:

division_name

string

Must not be greater than 255 characters.

Example:

tfxggzyleogofcmsizpspjz

is_default

boolean

Example:

repeat_days

integer[]

required

Must be between 1 and 7.

Example:

[1]

rows

integer[]

required

Must have at least 1 items. Must not have more than 20 items.

position

integer

required

Must be at least 0. Must not be greater than 19.

Example:

capability_id

integer

Example:

project_id

integer

Example:

activity_id

integer

Example:

capability_name

string

Must not be greater than 255 characters.

Example:

cfjbrxsmxdqbjpjditdxck

project_name

string

Must not be greater than 255 characters.

Example:

fyitg

activity_name

string

Must not be greater than 255 characters.

Example:

uvvicyfvedywztutzdpqgd

activity_info

string

Must not be greater than 1000 characters.

Example:

atfwydntsamclppfyulk

time_spent

string

Must not be greater than 60 characters.

Example:

kcuuxvwruwjqpqssgqelyo

note

string

Must not be greater than 5000 characters.

Example:

xscnnqc

Example request:

curl --request POST \
    "https://time-tracker-backend.pinnguaq.com/api/user/time-card-templates" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"fesceooyy\",
    \"division_id\": 16,
    \"division_name\": \"tfxggzyleogofcmsizpspjz\",
    \"is_default\": true,
    \"repeat_days\": [
        1
    ],
    \"rows\": \"xw\"
}"

Replace a template wholesale.

PUT

PATCH

https://time-tracker-backend.pinnguaq.com

/api/user/time-card-templates/{id}

requires authentication

Rows are replaced rather than diffed: the client always sends the full card, and a positional diff would be more code for an identical result.

Headers

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the time card template.

Example:

Body Parameters

name

string

required

Must not be greater than 60 characters.

Example:

eqwzszuweirjgywkbcmwzqe

division_id

integer

required

Example:

division_name

string

Must not be greater than 255 characters.

Example:

gqeextiupi

is_default

boolean

repeat_days

integer[]

required

Must be between 1 and 7.

Example:

[1]

rows

integer[]

required

Must have at least 1 items. Must not have more than 20 items.

position

integer

required

Must be at least 0. Must not be greater than 19.

Example:

capability_id

integer

Example:

project_id

integer

Example:

activity_id

integer

Example:

capability_name

string

Must not be greater than 255 characters.

Example:

wbfkibd

project_name

string

Must not be greater than 255 characters.

Example:

activity_name

string

Must not be greater than 255 characters.

Example:

tfjglxiyy

activity_info

string

Must not be greater than 1000 characters.

Example:

time_spent

string

Must not be greater than 60 characters.

Example:

kwecfxuwppgfwtdzs

note

string

Must not be greater than 5000 characters.

Example:

plythrkqgwxllxryluvwhratf

Example request:

curl --request PUT \
    "https://time-tracker-backend.pinnguaq.com/api/user/time-card-templates/1" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"eqwzszuweirjgywkbcmwzqe\",
    \"division_id\": 10,
    \"division_name\": \"gqeextiupi\",
    \"is_default\": false,
    \"repeat_days\": [
        1
    ],
    \"rows\": \"ssegiqnjvsqkbx\"
}"

Delete a template, releasing it as the default first if it was one.

DELETE

https://time-tracker-backend.pinnguaq.com

/api/user/time-card-templates/{id}

requires authentication

The pointer is cleared explicitly rather than left to the FK's nullOnDelete: SQLite only enforces referential actions when the foreign_keys pragma is on, so relying on it would mean the tests and production MySQL disagreed about whether the default survived a delete. The constraint stays in place as a backstop for any other delete path.

Headers

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the time card template.

Example:

Example request:

curl --request DELETE \
    "https://time-tracker-backend.pinnguaq.com/api/user/time-card-templates/1" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

TimeRecord

Get All

GET

https://time-tracker-backend.pinnguaq.com

/api/user/time-records

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

paginate

boolean

Field to paginate. Defaults to true.

Example:

page

integer

Field to paginate. Defaults to null.

Example:

perPage

integer

Field to paginate. Defaults to null.

Example:

filterBy

string

Field to filterBy. Defaults to null.

Example:

date

filterValue

string

Field to filterValue. Defaults to null.

Example:

2024-02-28

Example request:

curl --request GET \
    --get "https://time-tracker-backend.pinnguaq.com/api/user/time-records?paginate=1&page=1&perPage=1&filterBy=date&filterValue=2024-02-28" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "success": true,
    "status_code": 200,
    "message": [
        "Record fetched successfully."
    ],
    "data": {
        "list": [
            {
                "id": 6,
                "user_id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                "division_id": 1,
                "capability_id": 1,
                "activity_id": 1,
                "project_id": 1,
                "user": {
                    "id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                    "username": "pinnguaq-9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                    "first_name": "Updated John2",
                    "last_name": "Updated Do2e",
                    "phone": "98765432120",
                    "email": "updated.j12ohn.doe@example.com",
                    "email_verified_at": null,
                    "role": "user",
                    "picture": "profile.png",
                    "created_at": "2024-03-04T08:47:58.000000Z",
                    "updated_at": "2024-03-04T08:47:58.000000Z",
                    "deleted_at": null
                },
                "capability": {
                    "id": 1,
                    "name": "John",
                    "created_at": "2024-03-04T08:46:13.000000Z",
                    "updated_at": "2024-03-04T08:46:13.000000Z"
                },
                "activity": {
                    "id": 1,
                    "name": "John",
                    "created_at": "2024-03-04T08:46:33.000000Z",
                    "updated_at": "2024-03-04T08:46:33.000000Z"
                },
                "project": {
                    "id": 1,
                    "project_no": "1",
                    "name": "John",
                    "created_at": "2024-03-04T08:49:22.000000Z",
                    "updated_at": "2024-03-04T08:49:22.000000Z"
                },
                "date": "2024-03-01",
                "note": "This is a sample note",
                "time_spent": "2 hours",
                "created_at": "2024-03-04T08:50:46.000000Z",
                "updated_at": "2024-03-04T08:50:46.000000Z"
            },
            {
                "id": 5,
                "user_id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                "division_id": 1,
                "capability_id": 1,
                "activity_id": 1,
                "project_id": 1,
                "user": {
                    "id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                    "username": "pinnguaq-9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                    "first_name": "Updated John2",
                    "last_name": "Updated Do2e",
                    "phone": "98765432120",
                    "email": "updated.j12ohn.doe@example.com",
                    "email_verified_at": null,
                    "role": "user",
                    "picture": "profile.png",
                    "created_at": "2024-03-04T08:47:58.000000Z",
                    "updated_at": "2024-03-04T08:47:58.000000Z",
                    "deleted_at": null
                },
                "capability": {
                    "id": 1,
                    "name": "John",
                    "created_at": "2024-03-04T08:46:13.000000Z",
                    "updated_at": "2024-03-04T08:46:13.000000Z"
                },
                "activity": {
                    "id": 1,
                    "name": "John",
                    "created_at": "2024-03-04T08:46:33.000000Z",
                    "updated_at": "2024-03-04T08:46:33.000000Z"
                },
                "project": {
                    "id": 1,
                    "project_no": "1",
                    "name": "John",
                    "created_at": "2024-03-04T08:49:22.000000Z",
                    "updated_at": "2024-03-04T08:49:22.000000Z"
                },
                "date": "2024-03-01",
                "note": "This is a sample note",
                "time_spent": "2 hours",
                "created_at": "2024-03-04T08:49:43.000000Z",
                "updated_at": "2024-03-04T08:49:43.000000Z"
            },
            {
                "id": 4,
                "user_id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                "division_id": 1,
                "capability_id": 1,
                "activity_id": 1,
                "project_id": 1,
                "user": {
                    "id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                    "username": "pinnguaq-9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
                    "first_name": "Updated John2",
                    "last_name": "Updated Do2e",
                    "phone": "98765432120",
                    "email": "updated.j12ohn.doe@example.com",
                    "email_verified_at": null,
                    "role": "user",
                    "picture": "profile.png",
                    "created_at": "2024-03-04T08:47:58.000000Z",
                    "updated_at": "2024-03-04T08:47:58.000000Z",
                    "deleted_at": null
                },
                "capability": {
                    "id": 1,
                    "name": "John",
                    "created_at": "2024-03-04T08:46:13.000000Z",
                    "updated_at": "2024-03-04T08:46:13.000000Z"
                },
                "activity": {
                    "id": 1,
                    "name": "John",
                    "created_at": "2024-03-04T08:46:33.000000Z",
                    "updated_at": "2024-03-04T08:46:33.000000Z"
                },
                "project": {
                    "id": 1,
                    "project_no": "1",
                    "name": "John",
                    "created_at": "2024-03-04T08:49:22.000000Z",
                    "updated_at": "2024-03-04T08:49:22.000000Z"
                },
                "date": "2024-03-02",
                "note": "This is a sample note",
                "time_spent": "2 hours",
                "created_at": "2024-03-04T08:49:38.000000Z",
                "updated_at": "2024-03-04T08:49:38.000000Z"
            }
        ],
        "pagination": {
            "total": 3,
            "per_page": 10,
            "current": 1,
            "first": 1,
            "last": 1,
            "previous": null,
            "next": null,
            "pages": [
                1
            ],
            "from": 1,
            "to": 3
        }
    }
}

Create

POST

https://time-tracker-backend.pinnguaq.com

/api/user/time-records

requires authentication

Store new divsion

Headers

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

division_id

integer

required

Example:

capability_id

integer

required

Example:

date

string

required

Must be a valid date.

Example:

2026-10-15T14:47:12

time_spent

string

required

Example:

province

string

Must be one of:

AB
BC
MB
NB
NL
NS
NT
NU
ON
PE
QC
SK
YT

Example:

google_event_id

string

Example:

omnis

version

integer

Example:

activity_id

integer

Example:

activity_info

string

This field is required when activity_id is not present.

Example:

project_id

integer

Example:

note

string

This field is required when project_id is not present.

Example:

iusto

Example request:

curl --request POST \
    "https://time-tracker-backend.pinnguaq.com/api/user/time-records" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"division_id\": 14,
    \"capability_id\": 14,
    \"date\": \"2026-10-15T14:47:12\",
    \"time_spent\": \"et\",
    \"province\": \"NU\",
    \"google_event_id\": \"omnis\",
    \"version\": 2,
    \"activity_id\": 11,
    \"activity_info\": \"at\",
    \"project_id\": 19,
    \"note\": \"iusto\"
}"

Example response:

{
    "success": true,
    "status_code": 201,
    "message": [
        "Record created successfully."
    ],
    "data": {
        "id": 6,
        "user_id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
        "division_id": 1,
        "capability_id": 1,
        "activity_id": 1,
        "project_id": 1,
        "date": "2024-03-01",
        "note": "This is a sample note",
        "time_spent": "2 hours",
        "created_at": "2024-03-04T08:50:46.000000Z",
        "updated_at": "2024-03-04T08:50:46.000000Z",
        "deleted_at": null
    }
}

Show

GET

https://time-tracker-backend.pinnguaq.com

/api/user/time-records/{id}

requires authentication

Show existing by id

Headers

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the time record.

Example:

Example request:

curl --request GET \
    --get "https://time-tracker-backend.pinnguaq.com/api/user/time-records/36" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "success": true,
    "status_code": 200,
    "message": [
        "Record fetched successfully."
    ],
    "data": {
        "id": 4,
        "user_id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
        "division_id": 1,
        "capability_id": 1,
        "activity_id": 1,
        "project_id": 1,
        "user": {
            "id": "9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
            "username": "pinnguaq-9b7b60d5-20bd-40cd-ac33-f8bf84749c02",
            "first_name": "Updated John2",
            "last_name": "Updated Do2e",
            "phone": "98765432120",
            "email": "updated.j12ohn.doe@example.com",
            "email_verified_at": null,
            "role": "user",
            "picture": "profile.png",
            "created_at": "2024-03-04T08:47:58.000000Z",
            "updated_at": "2024-03-04T08:47:58.000000Z",
            "deleted_at": null
        },
        "capability": {
            "id": 1,
            "name": "John",
            "created_at": "2024-03-04T08:46:13.000000Z",
            "updated_at": "2024-03-04T08:46:13.000000Z"
        },
        "activity": {
            "id": 1,
            "name": "John",
            "created_at": "2024-03-04T08:46:33.000000Z",
            "updated_at": "2024-03-04T08:46:33.000000Z"
        },
        "project": {
            "id": 1,
            "project_no": "1",
            "name": "John",
            "created_at": "2024-03-04T08:49:22.000000Z",
            "updated_at": "2024-03-04T08:49:22.000000Z"
        },
        "date": "2024-03-02",
        "note": "This is a sample note",
        "time_spent": "2 hours",
        "created_at": "2024-03-04T08:49:38.000000Z",
        "updated_at": "2024-03-04T08:49:38.000000Z"
    }
}

Update

PUT

PATCH

https://time-tracker-backend.pinnguaq.com

/api/user/time-records/{id}

requires authentication

update by id

Headers

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the time record.

Example:

Body Parameters

division_id

integer

required

Example:

capability_id

integer

required

Example:

date

string

required

Must be a valid date.

Example:

2026-10-15T14:47:12

time_spent

string

required

Example:

sed

province

string

Must be one of:

AB
BC
MB
NB
NL
NS
NT
NU
ON
PE
QC
SK
YT

Example:

google_event_id

string

Example:

version

integer

Example:

activity_id

integer

Example:

activity_info

string

This field is required when activity_id is not present.

Example:

sunt

project_id

integer

Example:

note

string

This field is required when project_id is not present.

Example:

magni

Example request:

curl --request PUT \
    "https://time-tracker-backend.pinnguaq.com/api/user/time-records/36" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"division_id\": 12,
    \"capability_id\": 4,
    \"date\": \"2026-10-15T14:47:12\",
    \"time_spent\": \"sed\",
    \"province\": \"PE\",
    \"google_event_id\": \"et\",
    \"version\": 2,
    \"activity_id\": 9,
    \"activity_info\": \"sunt\",
    \"project_id\": 19,
    \"note\": \"magni\"
}"

Example response:

{
    "success": true,
    "status_code": 200,
    "message": [
        "Record updated successfully."
    ],
    "data": true
}

Delete

DELETE

https://time-tracker-backend.pinnguaq.com

/api/user/time-records/{id}

requires authentication

Headers

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the time record.

Example:

Example request:

curl --request DELETE \
    "https://time-tracker-backend.pinnguaq.com/api/user/time-records/36" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

Time Tracker

Time Tracker

Introduction

Authenticating requests

Activity

Get All

Headers

Query Parameters

Auth

Login

Headers

Body Parameters

Refresh

Headers

Logout

Headers

Get Profile

Headers

Update Profile

Headers

Body Parameters

Delete Profile

Headers

Capability

Get All

Headers

Query Parameters

Division

Get All

Headers

Query Parameters

Project

Get All

Headers

Query Parameters

TimeCardTemplate

Stop pre-filling new cards. Idempotent.

Headers

Make this template the one pre-filled onto every new card.

Headers

URL Parameters

List the caller's templates.

Headers

Create a template.

Headers

Body Parameters

Replace a template wholesale.

Headers

URL Parameters

Body Parameters

Delete a template, releasing it as the default first if it was one.

Headers

URL Parameters

TimeRecord

Get All

Headers

Query Parameters

Create

Headers

Body Parameters

Show

Headers

URL Parameters

Update

Headers

URL Parameters

Body Parameters

Delete

Headers

URL Parameters