> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Datagma Job Change Detection: Inputs, Cost & CLI Example

> Check whether a known contact has changed companies. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=datagma_job_change_detection:{}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name                  | Type     | Required | Default | Description                                                                                                                                                                            |
| --------------------- | -------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.firstName`   | `string` | No       |         | The first name of the person whose status you want to check                                                                                                                            |
| `payload.lastName`    | `string` | No       |         | The last name of the person whose status you want to check                                                                                                                             |
| `payload.fullName`    | `string` | No       |         | Instead of input firstname, lastname. You can input full name here                                                                                                                     |
| `payload.companyName` | `string` | No       |         | The last known company for this person                                                                                                                                                 |
| `payload.jobTitle`    | `string` | No       |         | If you think that more than one person may have the same name in this company, please do not hesitate to give us the last known job title, so that our AI can choose the right person. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Detect in real time if one of your contacts has changed company or if he still works in the same company.",
    "properties": {
      "firstName": {
        "type": "string",
        "description": "The first name of the person whose status you want to check"
      },
      "lastName": {
        "type": "string",
        "description": "The last name of the person whose status you want to check"
      },
      "fullName": {
        "type": "string",
        "description": "Instead of input firstname, lastname. You can input full name here"
      },
      "companyName": {
        "type": "string",
        "description": "The last known company for this person"
      },
      "jobTitle": {
        "type": "string",
        "description": "If you think that more than one person may have the same name in this company, please do not hesitate to give us the last known job title, so that our AI can choose the right person."
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `result.meta` | `object` | No       |         | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string"
              },
              "lastName": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "linkedIn": {
                "type": "string"
              },
              "currentCompany": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "experiences": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "company": {
                      "type": "string"
                    },
                    "jobTitle": {
                      "type": "string"
                    },
                    "duration": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "ableToGetPastExperience": {
                "type": "boolean"
              },
              "ableToFindCompanyInputInProfile": {
                "type": "boolean"
              },
              "from": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "status": {
            "type": "string"
          },
          "companyScore": {
            "type": "number",
            "format": "float"
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute datagma_job_change_detection --payload '{}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Cost

* Pricing model: `provider_usage` (provider usage).
* Estimated Deepline credits: `0.14` per pricing unit.
* Billing mode: `post_deduct`.