---
updatedAt: 2025-07-10T15:00:52.000Z
agentTools:
  projectIndex: https://docs.fideo.ai/llms.txt
---

# IP Address Signals

Receive IP Address signals associated with an individual to flag suspicious activities or validate identities.

IP Address Signals enables you to retrieve a list of all known IP Addresses and associated metadata of a given contact. These signals will be returned within the `ipAddresses` key.

```Text Example Request
curl -X POST \
  https://api.fideo.ai/signals \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
  "emails": [
    "sally.smith@gmail.com"
  ],
  "phones": [
    "+15552227799"
  ],
  "location": {
    "addressLine1": "123 Main Street",
    "city": "Denver",
    "region": "Colorado",
    "regionCode": "CO",
    "postalCode": "80203"
  },
  "name": {
    "given": "Sally",
    "family": "Smith"
  },
  "profiles": [{
    "service": "twitter",
    "username": "smith"
    }, {
    "service": "twitter",
    "userid": "123456"
    }, {
    "service": "linkedin",
    "url": "https://www.linkedin.com/in/sallysmi"
    }, {
    "service": "github",
    "url": "https://www.github.com/smith"
    }]
  }'
```
```Text Response
{
  "ipAddresses": [
    {
      "id": "192.158.1.38",
      "firstSeenMs": 1350021600,
      "lastSeenMs": 1640415600,
      "confidence": 0.95
    }
  ]
}

```

<br />

### IP Address Signals Response Properties

| Property Name            | Type    | Description                                                                          |
| :----------------------- | :------ | :----------------------------------------------------------------------------------- |
| ipAddresses.id           | string  | The IP address associated with an individual. (Usually IPv4)                         |
| ipAddresses.firstSeenMs  | long    | The first time this IP was seen by Fideo, in milliseconds (13 digit timestamp)       |
| ipAddresses.lastSeenMs   | long    | The most recent time this IP was seen by Fideo, in milliseconds (13 digit timestamp) |
| ipAddresses.observations | integer | The number of times in our graph we've seen of an IP connected to the individual     |
| ipAddresses.confidence   | double  | Numerical score of confident we are that this IP belongs to the individual (0.0-1.0) |

### Response Codes & Errors

| Response Codes            | Message                                                                                                                                             |
| :------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200 - OK                  | Your request was successful                                                                                                                         |
| 204 - No Content          | Individual is not found within Fideo's Identity Graph                                                                                               |
| 400 - Bad Request         | Your request was invalid                                                                                                                            |
| 500 - Server Error        | Something is broken on Fideo's side. If you encounter this, please contact us at [support@fideo.ai](mailto:support@fullcontact.com) for assistance. |
| 503 - Service Unavailable | There is a transient downstream error condition. We include a 'Retry-After' header dictating when to attempt the call again.                        |