# How to call API?
Base URL: Calls for ReferralHero API are relative to the URL
```
https://app.referralhero.com/api/sdk/v1/
```
#### Request Headers
1. Authorization - Your access token
2. Accept - `application/vnd.referralhero.v1`
3. Content-Type - `application/json`
To summarize, your request headers should look like this
```jsx
{
'Content-Type': 'application/json',
'Accept': 'application/vnd.referralhero.v1',
'Authorization': 'xxxxxxxxxx'
}
```
**Step 1:** Prepare Your Environment
1. Open your React Native project.
2. Install a library for making HTTP requests, such as axios or use the built-in fetch API.
**Step 2:** Make Your First API Call
1. Set up your API call:
```jsx
const apiUrl = 'https://app.referralhero.com/api/sdk/v1/';
const apiToken = 'Your-api-token';
axios.get(`${apiUrl}endpoint`, {
headers: {
'Content-Type': 'application/json',
'Accept': 'application/vnd.referralhero.v1',
'Authorization': apiToken
}
})
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error('Error making API call', error);
});
```
**Step 3:**
1. On the ReferralHero overview, click to edit your desired Campaign.
2. Then the Installation tab, then Mobile App Installation.
3. Get your `UUID`: The 12-letter ID that starts with ‘MF’ in *Edit Campaign > launch > Mobile app installation*, e.g. MF15298bba6d.
4. Add the Campaign Token obtained from the campaign, and UUID from the installation Tab.
**Step 4:**
In the Goal section of your Campaign settings, ensure you have added the Google Play and Apple App Store links and a default referral link for desktop web users.
Well done! You should now be able to build and run your campaign. Before using the more advanced features of the API, you should learn about a couple of important concepts.
#### Helper Functions
**Get Device Type**
You can use the `react-native-device-info` library to get the device type.
```jsx
import DeviceInfo from 'react-native-device-info';
function getDeviceType() {
let deviceType = "Desktop";
if (Platform.OS === 'ios')
{ if (DeviceInfo.getModel().toLowerCase().includes("ipad")) {
deviceType = "iPad";
} else if (DeviceInfo.getModel().toLowerCase().includes("ipod")) {
deviceType = "iPod";
} else { deviceType = "iPhone"; }
} else if (Platform.OS === 'android') {
deviceType = "Android";
} else if (Platform.OS === 'windows') {
deviceType = "Windows Phone";
} else if (Platform.OS === 'blackberry') {
deviceType = "BlackBerry";
} else {
deviceType = "Unknown Device";
}
return deviceType;
}
```
**Get Operating System**
You can use the `Platform` module from React Native to get the operating system type.
```jsx
import { Platform } from 'react-native';
function getOperatingSystem() {
return Platform.OS; // Returns 'ios' or 'android'
}
```
### Adding the Subscriber Data
With this information, you should be able to add the subscriber data using the `addSubscriber` method to automatically identify or track a referral:
```jsx
function formSubmit() {
axios.post(`https://app.referralhero.com/api/sdk/v1/lists/MFxxxxxxxxx/subscribers`, referralParams, {
headers: {
'Content-Type': 'application/json',
'Accept': 'application/vnd.referralhero.v1',
'Authorization': apiToken
}
})
.then(response => {
console.log('Subscriber added successfully:', response.data);
})
.catch(error => {
console.error('Error adding subscriber', error);
});
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://berylsystems.gitbook.io/referral-hero-documentation/integrations/mobile-sdks/react-native/how-to-call-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
