---
title: APIs
description: "All endpoints are protected by an API key. Once you generate the API key, send it through the Authorization header in the following way: To generate the API key, go to the Credentials page, click on '"
---

[Skip to content](https://docs.ironchip.com/en/apis#main-content)

- [English](https://docs.ironchip.com/en/apis)
- [Español](https://docs.ironchip.com/apis)

English

Show submenu for translations

[Contac us](https://docs.ironchip.com/en/kb-tickets/new?hsLang=en) [Customer portal](https://support.ironchip.com/tickets?hsLang=en)

![01\_1-ironchip\_logo\_articulación horizontal\_ppal.png\]](https://docs.ironchip.com/hs-fs/hubfs/01_1-ironchip_logo_articulacio%CC%81n%20horizontal_ppal.png?height=40&name=01_1-ironchip_logo_articulacio%CC%81n%20horizontal_ppal.png)

Open main navigation

Close main navigation

- - [English](https://docs.ironchip.com/en/apis)
    - [Español](https://docs.ironchip.com/apis)

  English
  
  Show submenu for translations
- [Contac us](https://docs.ironchip.com/en/kb-tickets/new)
- [Customer portal](https://support.ironchip.com/tickets)
- Contact Us

 Contact Us

 Hello. ¿How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://docs.ironchip.com/en?hsLang=en)
2. [Fraud Detection platform](https://docs.ironchip.com/en/fraud-detection-platform?hsLang=en)
3. [For developers](https://docs.ironchip.com/en/fraud-detection-platform?hsLang=en#for-developers)

# APIs

### Generating an API access key

All endpoints are protected by an API key.

Once you generate the API key, send it through the Authorization header in the following way:

```
`Authorization: <apikey>`
```

To generate the API key, go to the Credentials page, click on 'Generate API key':

![](https://knowledge.ironchip.com/hs-fs/hubfs/generate-access-api-key-png.png?width=679&height=388&name=generate-access-api-key-png.png)

With this API key, you will have access to all possible requests. The generated QR is used to synchronize the mobile app with the dashboard.

### API Libraries

Official libraries are available to assist integration with the Ironchip API. These libraries serve as API containers and handle functions like:

- Transparent API authentication
- Requests for all available endpoints
- HTTP error handling

### Understanding Risk Assessments

### Understanding Risk Assessments

![](https://knowledge.ironchip.com/hs-fs/hubfs/risk-assessment-png.png?width=363&height=193&name=risk-assessment-png.png)

Ironchip can provide four types of risk assessments, which depend on our level of confidence in a certain action performed by a device:

- **fraud**: Ironchip considers the action performed by the device to be fraudulent, involved in a fraud
- **high\_risk**: Ironchip considers the action (e.g. registration, login) performed by the device to be potentially fraudulent and recommends taking preventive measures in these scenarios.
- **low\_risk**: Ironchip considers this action performed by the device to be safe to accept.
- **unknown\_risk**: Ironchip cannot provide an accurate assessment at the time of the request.

### Risk assessment evidence

Ironchip's APIs are based on evidence to provide risk assessments. This decision is based on different analyses through distinct lenses.

The following table describes the possible evidence values, their meaning, and the use cases they affect.

### Understanding the type of sensor match

| Match Type | Description |
| --- | --- |
| gps | When Ironchip is able to make comparisons by GPS data. |
| wifi\_scan | When Ironchip can make comparisons using Wi-Fi sensors, but no matching connected networks are found. |
| wifi\_connection | When Ironchip is able to make comparisons by connected Wi-Fi networks. |
| mobile\_networks | When Ironchip is able to make comparisons by connected mobile networks. |

### Risk Assessment Decision

Ironchip's APIs are based on decisions to provide risk assessments. This decision is based on different analyses through different lenses.

![](https://knowledge.ironchip.com/hs-fs/hubfs/decision-state-png.png?width=368&height=201&name=decision-state-png.png)

The following table describes the possible decision values, their meaning, and the use cases that affect them.

| Decision | Description | Type |
| --- | --- | --- |
| SIM Swapping / ATO | Account takeover detected based on the Sim Swapping attack or not (depending on the client user's protection) | string |
| Phising | Phishing attack detected from a specific location (multiple ATO) | string |
| Synthetic identity | Synthetic identity attack detected | string |
| New user | New user detected on the Ironchip platform | string |
| Location fraud | Location fraud attempt detected by the user comparing all location data sources | string |
| Banned location | Location detected from a banned place. In the example: Location detected from Russia | string |
| Device Swapping | Legitimate device swap detected from a user | string |
| Location Swapping | Legitimate location swap detected from a user | string |
| Common usage | Common usage detected | string |

### Reports API

Location-Based Fraud Reports API

### Information

### Version

api/v1.0.5-5-gc944fcf

### Contact

Support page [info@ironchip.com](mailto:info@ironchip.com) [https://www.ironchip.com/products/location\_based\_fraud.html](https://www.ironchip.com/products/location_based_fraud.html)

### Terms of Service

[https://www.ironchip.com/term\_uses/terms.html](https://www.ironchip.com/term_uses/terms.html)

### Content Negotiation

### URI Schemes

- http

### Uses

- application/json

### Response Type

- application/json

### Access Control

### Security Schemes

ApiKeyAuth (header: Authorization)

### All Connection Points

### Report

| Method | URI | Name | Summary |
| --- | --- | --- | --- |
| GET | /reports | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports) | This endpoint allows the client to get the application's reports. The user should be allowed to consult reports from the referenced application. |
| GET | /reports/{transaction\_id} | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id) | This endpoint allows the client to get the application's reports by providing the transaction ID. The user should be allowed to consult reports from the referenced application. |

### Feedback

| Method | URI | Name | Summary |
| --- | --- | --- | --- |
| POST | /feedback/{transaction\_id} | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id) | This endpoint allows the client to send feedback on the received report to improve future fraud detections. |

### Reports

### This endpoint allows the client to get the reports from the application. The user should be allowed to consult reports from the Application. (*GetReports*)

```
GET /reports
```

Get all reports from the application. By default, they will be paginated to 20 reports per page.

### Response Type

- application/json

### Security Requirements

- ApiKeyAuth

### Parameters

| Name | Origin | Type | Go Type | Separator | Mandatory | Mandatory | Description |
| --- | --- | --- | --- | --- | --- | --- | --- |
| limit | query | integer | int64 |  |  | 20 | Limit of number of reports |
| page | query | integer | int64 |  |  | 1 | Reports page |

### Example

```
curl -X 'GET' \\  '<https://report.lbfraud.ironchip.com/reports?limit=20&page=1>' \\  -H 'accept: application/json' \\  -H 'Authorization: example-api-key'
```

### All responses

| Code | Status | Description | Has headers | Scheme |
| --- | --- | --- | --- | --- |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-200](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-200) | OK | OK |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-200-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-200-schema) |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-404](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-404) | Not Found | Not Found |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-404-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-404-schema) |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-500](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-500) | Internal Server Error | Internal Server Error |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-500-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-500-schema) |

### Responses

### 200 - OK

Status: OK

### Scheme

- \[ \] \[ \][ModelsReport](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-report)

### 404 - Not Found

Status: Not Found

### Scheme

[ModelsRestError](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-rest-error)

### 500 - Internal Server Error

Status: Internal Server Error

### Scheme

[ModelsRestError](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-rest-error)

### This endpoint allows the client to obtain the reports from the application by providing the transaction ID. The user should be allowed to consult reports from the Application. (*GetReportsTransactionID*)

```
GET /reports/{transaction_id}
```

Get the application reports filtered by transaction ID. Reports will by default be paginated to 20 per page. The timeout parameter is the maximum waiting time for the report to be processed; it should be used if the report is requested before the transaction is completed.

### Response Type

- application/json

### Security Requirements

- ApiKeyAuth

### Parameters

| Name | Origin | Type | Go Type | Mandatory | Default | Description |
| --- | --- | --- | --- | --- | --- | --- |
| transaction\_id | path | string | string | ✓ |  | Transaction ID |
| limit | query | integer | int64 |  | 20 | Limit of the number of reports |
| page | query | integer | int64 |  | 1 | From the report generation (numbers and unit suffix) |
| since | query | string | string |  | "30d" | From the report generation (numbers and unit suffix) |
| timeout | query | string | string |  | "5s" | Wait time in seconds |

### Example

```
curl -X 'GET' \\  '<https://report.lbfraud.ironchip.com/reports/example-transaction-id?limit=1&page=1&since=30d&timeout=5s>' \\  -H 'accept: application/json' \\  -H 'Authorization: example-api-key'
```

### All responses

| Code | Status | Description | Has Headers | Schema |
| --- | --- | --- | --- | --- |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-200](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-200) | OK | OK |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-200-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-200-schema) |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-404](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-404) | Not Found | Not Found |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-404-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-404-schema) |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-500](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-500) | Internal Server Error | Internal Server Error |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-500-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#get-reports-transaction-id-500-schema) |

### Responses

### 200 - OK

Status: OK

### Schema

- \[ \] \[ \][ModelsReport](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-report)

### 404 - Not Found

Status: Not Found

### Schema

[ModelsRestError](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-rest-error)

### 500 - Internal Server Error

Status: Internal Server Error

### Schema

[ModelsRestError](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-rest-error)

### Feedback

### This route allows the client to post comments about the received report to improve future fraud detections. (*PostFeedbackTransactionID*)

```
POST /feedback/{transaction_id}
```

Comment on the received transaction to improve future results in fraud detections.

### Use

- application/json

### Security Requirements

- ApiKeyAuth

### Parameters

| Name | Origin | Type | Type in Go | Separator | Mandatory | Default | Description |
| --- | --- | --- | --- | --- | --- | --- | --- |
| transaction\_id | path | string | string |  | ✓ |  | Transaction ID |
| feedback | body | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-feedback](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-feedback) | models.ModelsFeedback |  | ✓ |  | Feedback |

### Example

```
curl -X 'POST' \\  '<https://report.lbfraud.ironchip.com/feedback/example-transaction-id>' \\  -H 'accept: application/json' \\  -H 'Authorization: example-api-key' \\  -H 'Content-Type: application/json' \\  -d '{  "behaviour": {    "desired": {      "fraud_cases": [        "device swapping",        "location swapping"      ],      "risk_assignment": "clear"    }  },  "impact": {    "description": "The transaction has been detected as fraud rather than low"  },  "reporter": {    "email": "TatianaPrieto@ironchip.com",    "name": "Tatiana",    "surname": "Prieto"  },  "situation": {    "description": "The customer has downloaded the APP to an unknown device located in a new country"  },  "valuation": {    "annotations": "It is not possible to difference between real and fake client without client confirmation",    "score": 8,    "type": "Corrective"  }}'
```

### All Responses

| Code | Status | Description | Has headers | Schema |
| --- | --- | --- | --- | --- |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-200](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-200) | OK | OK |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-200-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-200-schema) |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-404](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-404) | Not Found | Not Found |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-404-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-404-schema) |
| [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-500](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-500) | Internal Server Error | Internal Server Error |  | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-500-schema](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#post-feedback-transaction-id-500-schema) |

### Responses

### 200 - OK

Status: OK

### Schema

### 404 - Not Found

Status: Not Found

### Schema

[ModelsRestError](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-rest-error)

### 500 - Internal Server Error

Status: Internal Server Error

### Schema

[ModelsRestError](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-rest-error)

### Models

### models.Address

**Properties**

| Name | Type | Type in Go | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| city | string | string |  |  | City where the report occurred |
| country | string | string |  |  | Name of the country |
| country\_code | string | string |  |  | Country codes are short alphabetic (ISO 3166) |
| latitude | number | float64 |  |  | Coordinate specifying the north-south position of a point on the Earth's surface |
| longitude | number | float64 |  |  | Coordinate specifying the east-west position of a point on the Earth's surface |
| region | string | string |  |  | Geographical region of a country used for administrative purposes |
| state | string | string |  |  | Geographical areas into which a particular country is divided |

### models.Behaviour

**Properties**

| Name | Type | Go Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| desired | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-desired-behaviour](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-desired-behaviour) | ModelsDesiredBehaviour | ✓ |  | Desired behaviour |

### models.DesiredBehaviour

**Properties**

| Name | Type | Go Type | Required | Description | Example |
| --- | --- | --- | --- | --- | --- |
| fraud\_cases | \[\]string | \[\]string |  | Report case, reason | \["device change","location change"\] |
| risk\_assignment | string | string | ✓ | Risk level (fraud, high, low, clear) |  |

### models.Device

**Properties**

| Name | Type | Go Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| id | string | string |  |  | Unique device ID |
| integrity | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-integrity](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-integrity) | ModelsIntegrity |  |  | Device integrity |
| model | string | string |  |  | Device model |
| sensors | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-sensors](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-sensors) | ModelsSensors |  |  | Activated device sensors |

### models.EmLocation

**Properties**

| Name | Type | Go Type | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| address | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-address](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-address) | ModelsAddress |  |  | Location address |  |
| id | string | string |  |  | Location ID |  |

### models.Event

**Properties**

| Name | Type | Go Type | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| fraud\_cases | \[\]string | \[\]string |  |  | Report case, reason |  |
| id | string | string |  |  | Application transaction ID |  |
| risk\_assignment | string | string |  |  | Risk level (fraud, high, low, clear) |  |
| timestamp | integer | int64 |  |  | Event timestamp |  |

### models.Feedback

**Properties**

| Name | Type | Go Type | Required | Description |
| --- | --- | --- | --- | --- |
| behaviour | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-behaviour](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-behaviour) | ModelsBehaviour | ✓ | Product behaviour: expected |
| impact | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-impact](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-impact) | ModelsImpact |  | Impact of the results |
| reporter | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-reporter](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-reporter) | ModelsReporter |  | Identifying data of the person sending the feedback |
| situation | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-situation](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-situation) | ModelsSituation |  | The situation when the process was carried out |
| valuation | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-valuation](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-valuation) | ModelsValuation |  | Valuation of the results |

### models.GeoLocation

**Properties**

| Name | Type | Go Type | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| address | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-address](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-address) | ModelsAddress |  |  | Location address |  |
| id | string | string |  |  | Location ID |  |

### models.IP

**Properties**

| Name | Type | Go Type | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| address | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-address](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-address) | ModelsAddress |  |  | Location address |  |
| tor | boolean | bool |  |  | Is using TOR |  |
| vpn | boolean | bool |  |  | Is using VPN |  |

### models.Impact

**Properties**

| Name | Type | Go Type | Required | Description | Example |
| --- | --- | --- | --- | --- | --- |
| description | string | string |  | Description of the generated impact | The transaction has been detected as fraud instead of low |

### models.Integrity

**Properties**

| Name | Type | Go Type | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| debugged | boolean | bool |  |  | The device is open in debugging mode or the application is not built |  |
| emulated | boolean | bool |  |  | The device is being emulated |  |
| gps\_spoofed | boolean | bool |  |  | Is the GPS location or signal being spoofed? |  |
| rooted | boolean | bool |  |  | Is the device rooted or jailbroken? |  |

### models.Location

**Properties**

| Name | Type | Go Type | Required | Description |
| --- | --- | --- | --- | --- |
| address | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-address](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-address) | ModelsAddress |  | Location address |
| id | string | string |  | Location ID |
| location\_type | string | string |  | Location type (ip, geo, wifi, lte, cdma, wcdma, gsm) |

### models.Report

**Properties**

| Name | Type | Go Type | Required | Description |
| --- | --- | --- | --- | --- |
| application\_id | string | string |  | Application ID |
| descriptive\_report | string | string |  | Descriptive summary about the report data |
| device | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-device](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-device) | ModelsDevice |  | Device information |
| em\_location | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-em-location](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-em-location) | ModelsEmLocation |  | EM location information |
| event | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-event](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-event) | ModelsEvent |  | Report event outcome |
| extra\_data | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#interface](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#interface) | interface{} |  | Additional data provided in the transaction (JSON) |
| geo\_location | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-geo-location](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-geo-location) | ModelsGeoLocation |  | GEO location information |
| id | integer | int64 |  | Generated report ID |
| ip | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-ip](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-ip) | ModelsIP |  | IP information |
| location | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-location](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-location) | ModelsLocation |  | Location information |
| timestamp | integer | int64 |  | Report generation timestamp in nanoseconds |
| transaction\_id | string | string |  | Transaction ID |
| user | [https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-user](https://helpcenter.ironchip.com/es/fraud-detection/technical-documentation/apis/report-api/documentation/#models-user) | ModelsUser |  | User information |

### models.Reporter

**Properties**

| Name | Type | Type in Go | Required | Description | Example |
| --- | --- | --- | --- | --- | --- |
| email | string | string |  | Identifying email | [mailto:TatianaPrieto@ironchip.com](mailto:TatianaPrieto@ironchip.com) |
| name | string | string |  | Identifying name | Tatiana |
| surname | string | string |  | Identifying surname | Prieto |

### models.RestError

**Properties**

| Name | Type | Type in Go | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| cause | string | string |  |  |  |  |
| error | string | string |  |  |  |  |
| error\_code | string | string |  |  |  |  |
| traceability\_id | string | string |  |  |  |  |

### models.Sensors

**Properties**

| Name | Type | Go Type | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| gps | boolean | bool |  |  | Is the GPS sensor activated? |  |
| mobile\_networks | boolean | bool |  |  | Can the device access mobile networks? |  |
| wifi | boolean | bool |  |  | Is the WiFi sensor on the device activated? |  |
| wifi\_connected | boolean | bool |  |  | Is the device connected to a WiFi network? |  |

### models.Situation

**Properties**

| Name | Type | Go Type | Required | Description | Example |
| --- | --- | --- | --- | --- | --- |
| description | string | string |  | Description of the situation when the process was carried out | The client has downloaded the application on an unknown device located in a new country |

### models.User

**Properties**

| Name | Type | Go Type | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| id | string | string |  |  | User ID | exampleuserid |

### models.Valuation

**Properties**

| Name | Type | Go Type | Required | Description | Example |
| --- | --- | --- | --- | --- | --- |
| annotations | string | string |  | Annotations | It is not possible to differentiate between a real and fake customer without customer confirmation |
| score | integer | int64 |  | Valuation score (0-10) | 8 |
| type | string | string |  | Feedback rating type (Positive, Negative, Corrective) | Corrective |

### models.Version

**Properties**

| Name | Type | Go Type | Required | Default | Description | Example |
| --- | --- | --- | --- | --- | --- | --- |
| build\_date | string | string |  |  |  |  |
| commit | string | string |  |  |  |  |
| version | string | string |  |  |  | 1.0.0 |

- [Identity Platform](https://docs.ironchip.com/en/identity-platform?hsLang=en#main-content)

    - [User Guide](https://docs.ironchip.com/en/identity-platform?hsLang=en#user-guide)
    - [Administrator Guide](https://docs.ironchip.com/en/identity-platform?hsLang=en#administrator-guide)
    - [Get Started](https://docs.ironchip.com/en/identity-platform?hsLang=en#get-started)
    - [Integration protocols](https://docs.ironchip.com/en/identity-platform?hsLang=en#integration-protocols)
    - [Integrations](https://docs.ironchip.com/en/identity-platform?hsLang=en#integrations)
    - [SLA](https://docs.ironchip.com/en/identity-platform?hsLang=en#sla)
- [Fraud Detection platform](https://docs.ironchip.com/en/fraud-detection-platform?hsLang=en#main-content)

    - [Guides](https://docs.ironchip.com/en/fraud-detection-platform?hsLang=en#guides)
    - [For developers](https://docs.ironchip.com/en/fraud-detection-platform?hsLang=en#for-developers)
    - [SDK](https://docs.ironchip.com/en/fraud-detection-platform?hsLang=en#sdk)
- [Security & SLA](https://docs.ironchip.com/en/security-sla?hsLang=en)
- [FAQ's](https://docs.ironchip.com/en/faqs?hsLang=en#main-content)

    - [General](https://docs.ironchip.com/en/faqs?hsLang=en#general)
    - [Identity platform](https://docs.ironchip.com/en/faqs?hsLang=en#identity-platform)

[![Ironchip](https://docs.ironchip.com/hs-fs/hubfs/logohubspot.png?width=300&height=74&name=logohubspot.png "Ironchip")](http://www.ironchip.com)

Help center ironchip.net

Copyright © 2026, Ironchip Telco S.L.