# List Timesheets — Deel

> List IC contractor timesheets in Deel with optional filters for contract, status, date range, and contract type. Returns timesheet IDs, contract info, hours worked, status, and pay period. Use List Contracts to find contract IDs for…

- Key: `deel-list-timesheets`
- Type: Action (Read-only)
- Version: 0.0.2
- App: Deel (`deel`) — https://pipedream.com/apps/deel.md
- This page (HTML): https://pipedream.com/apps/deel/actions/list-timesheets
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/deel/actions/list-timesheets/list-timesheets.mjs

## Description

List IC contractor timesheets in Deel with optional filters for contract, status, date range, and contract type. Returns timesheet IDs, contract info, hours worked, status, and pay period. Use **List Contracts** to find contract IDs for filtering. [See the documentation](https://developer.deel.com/api/reference/endpoints/timesheets/get-timesheets)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `contractId` | `string` | No | The unique identifier of the Deel contract. Use List Contracts to find contract IDs. |
| `statuses` | `string[]` | No | Filter by timesheet status (e.g., pending, approved, declined). |
| `contractTypes` | `string[]` | No | Filter by contract type (e.g., fixed_rate_contract, pay_as_you_go_contract). |
| `dateFrom` | `string` | No | Start date filter in ISO 8601 format (e.g., 2026-01-01). |
| `dateTo` | `string` | No | End date filter in ISO 8601 format (e.g., 2026-06-30). |
| `limit` | `integer` | No | Maximum number of timesheets to return. |
| `offset` | `integer` | No | Number of records to skip for pagination. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "deel",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "deel-list-timesheets",
  arguments: {
    contractId: "Contract ID",
    statuses: ["Statuses"],
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "deel-list-timesheets",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    deel: { authProvisionId: "apn_xxxxxxx" },
    contractId: "Contract ID",
    statuses: ["Statuses"],
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "deel-list-timesheets",
    "configured_props": {
      "deel": { "authProvisionId": "apn_xxxxxxx" },
      "contractId": "Contract ID",
      "statuses": ["Statuses"]
    }
  }'
```

---

- App: https://pipedream.com/apps/deel.md · All apps: https://pipedream.com/apps