# findUserEmail

**Identifier:** `github_findUserEmail`

**Provider:** [GitHub API](https://kirha.com/providers/github.md)

Find email addresses for GitHub users by analyzing their repository commits

## Run it with the CLI

```bash
kirha tools run github_findUserEmail \
  --input '{
    "logins": [
      "<logins>"
    ]
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "github_findUserEmail",
  "input": {
    "logins": [
      "<logins>"
    ]
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "logins": {
      "description": "List of GitHub usernames to find emails for. Results array will be in the same order as the logins array. If more than 20 logins are provided, only the first 20 will be processed.",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "logins"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "users": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "description": "Commit author name, usually the person's real name.",
            "type": "string"
          },
          "username": {
            "type": "string"
          }
        },
        "required": [
          "username",
          "email"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "users"
  ],
  "type": "object"
}
```

-----

[All GitHub API tools](https://kirha.com/providers/github.md) · [< Back to tools list](https://kirha.com/tools.md)