Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
94 commits
Select commit Hold shift + click to select a range
efc01e0
add a separate yml file for teal-api
luchesar Mar 15, 2024
4a210d4
Users create done
luchesar Mar 15, 2024
3034279
users post complete along with response codes
luchesar Mar 15, 2024
bb9290b
Add GET /user endpoints
luchesar Mar 15, 2024
4969d25
Add examples for the user fields and extra formatting
luchesar Mar 15, 2024
e4fe4d1
List users endpoint documentation done
luchesar Mar 15, 2024
1ce740d
DELETE /users docu done
luchesar Mar 15, 2024
8b89647
PUST /user/{user_id}/token documentation
luchesar Mar 15, 2024
c33f4be
POST /users/{user_id}/account documentation
luchesar Mar 15, 2024
e654958
Intros + images
andre-teal Mar 15, 2024
cb55829
Merge branch 'docs2-update-open-api-definition-to-reflect-sandbox' in…
andre-teal Mar 15, 2024
3f7ff13
Delete account
andre-teal Mar 15, 2024
6af49b8
List accounts
andre-teal Mar 15, 2024
87e7d64
Entries - connection
andre-teal Mar 15, 2024
91fff48
Entries
andre-teal Mar 15, 2024
565c0c4
Delete fix
andre-teal Mar 15, 2024
e93c3f6
Fix 2 Delete
andre-teal Mar 15, 2024
109dfbc
Documents + webhook post
andre-teal Mar 15, 2024
dc94504
UI (small changes)
andre-teal Mar 15, 2024
3e49c0f
documentation for /webhooks
luchesar Mar 16, 2024
1014c0a
Documentation DELETE /webhoons/{webhook_id}
luchesar Mar 16, 2024
6a84fb5
Documentation for /payroll/{user_id} complete sceleton
luchesar Mar 17, 2024
8efa656
Small improvements of the pagination docu
luchesar Mar 17, 2024
6e69147
GET /payroll/{user_id} doc improvements
luchesar Mar 17, 2024
0e27bee
use BearerAuth for both connection and payslip post endpoints
luchesar Mar 17, 2024
a6f3d2c
Add the correct response types for connections and payslip endpoints
luchesar Mar 18, 2024
53e549d
Merge pull request #3 from Teal-Connect/docs2-update-open-api-definit…
luchesar Mar 18, 2024
cf83afd
Fixed the /entries response format and added filterings
luchesar Mar 18, 2024
30d3c97
Data push
andre-teal Mar 18, 2024
e2024b9
Sandbox + some minor fixes on endpoints grammar
andre-teal Mar 18, 2024
707069a
Merge branch 'general-content-update' of github.com:Teal-Connect/docs…
luchesar Mar 18, 2024
7ab0e58
refactor the locations of all endpoints
luchesar Mar 18, 2024
4b13ef9
Document endpoint updates. Remove secret from webhook responses
arun-singh Mar 18, 2024
56387ba
Update documents response with document object containing file contents
arun-singh Mar 19, 2024
cac6947
Merge pull request #5 from Teal-Connect/document-and-webhook-updates
arun-singh Mar 19, 2024
9f2f3b5
Examples added
andre-teal Mar 19, 2024
414b837
status code update
andre-teal Mar 20, 2024
958e83d
fix on status codes (204 added)
andre-teal Mar 20, 2024
8499b49
first version update for DATA
andre-teal Mar 20, 2024
c1f6219
Sandbox changes
andre-teal Mar 20, 2024
b538e01
version 2 sandbox update
andre-teal Mar 20, 2024
8bf422e
Quickstart updates + changes in URL names of pages
andre-teal Mar 21, 2024
27ddb56
Introduction JSON new
andre-teal Mar 21, 2024
3954145
remove punctuation from Introduction at the end of the JSON example, …
luchesar Mar 21, 2024
3ebb299
PAYROLL-API-3: Create user changes
arun-singh Mar 28, 2024
d65873f
Payroll-api-4: account endpoint updates (#17)
arun-singh Mar 30, 2024
c69274e
Feature #18 Add 404 not found response for DELETE endpoints (#19)
luchesar Apr 1, 2024
de413d0
Feature #20 Error messages in Responses should be an array of string …
luchesar Apr 1, 2024
9cb5140
payroll-api-4: change default limit on get accounts and remove ordere…
arun-singh Apr 8, 2024
b3d16b8
payroll-api-9: Update document fields
arun-singh Apr 8, 2024
dc16707
Update the data section
arun-singh Apr 15, 2024
42b4478
Create script for populating default sandbox values for clients
arun-singh Apr 15, 2024
8fc9fa8
Update webhook dedicated page
arun-singh Apr 17, 2024
3e9e3fc
Add user_name to all the accounts responses (#28)
luchesar Apr 22, 2024
646207d
post /webhooks can include payload in webhook request body (#29)
olavandeira Apr 23, 2024
4858d20
Add various small improvements and bugfixes (#32)
luchesar Apr 30, 2024
8ab1215
Add missing endpoint in documentation (#35)
olavandeira May 7, 2024
064f6b9
docs-14: Improve execution methods section
olavandeira May 9, 2024
e536911
docs-11: Improve sandbox section #31
olavandeira May 9, 2024
e0be6ed
Adding some more details about events and a few code examples for ver…
luchesar May 14, 2024
7ca0b21
Instructions for setting up a postman workspace (#36)
olavandeira May 17, 2024
f870df5
Feature payroll api#84 ext id to payroll and document endpoints (#37)
luchesar Jun 13, 2024
5764c3d
Add the missing query parameters in GET /payroll/{user_id} (#38)
luchesar Jun 14, 2024
b9bbf97
feature-39: Add possible values of employment_status (#40)
olavandeira Aug 20, 2024
6b110b5
Fix generator and add some better name values (#41)
arun-singh Oct 15, 2024
eb633ef
Add webapp link to user-token response model (#42)
arun-singh Oct 15, 2024
c0d755f
Add /members endpoints doc (#43)
luchesar Oct 15, 2024
51b1ef7
fix the invite member request (#44)
luchesar Oct 15, 2024
0988fed
fix the invite member request (#45)
luchesar Oct 15, 2024
e9b8641
Fix a typo in /members
luchesar Oct 15, 2024
715aa33
add signin documentation (#46)
luchesar Oct 17, 2024
2739715
add enum for the member role
luchesar Oct 18, 2024
f182ee2
feature: Update intro images (#47)
olavandeira Nov 5, 2024
87dd883
Add payslip errors field to payslip upload endpoint (#48)
arun-singh Nov 12, 2024
bd62e65
swith from staging to sandbox (#52)
luchesar Dec 10, 2024
382d973
Add sandbox oauth2 credentials
arun-singh Jan 9, 2025
76ff287
Feature 331: add recurring page and endpoint
arun-singh Jan 14, 2025
69098ea
replace gifs and sandbox oauth image
arun-singh Jan 14, 2025
0b4157f
feature-277: User level config
arun-singh Feb 12, 2025
789f5ab
feature-371: Account recurring endpoint
arun-singh Feb 12, 2025
bdf10d1
feature: add fraud risk to payroll_data (#56)
olavandeira Feb 13, 2025
119c56f
Data handling explanation and small fix to recurring field
arun-singh Mar 2, 2025
b55723f
feature-379: PUT users endpoint
arun-singh Mar 5, 2025
b65006b
update openapi.yml to include encryption_key (#65)
olavandeira Apr 8, 2025
f1bd369
Client config and sandbox month descriptions
arun-singh Apr 30, 2025
8eb62ac
chore: upgrade mintlify to v2 (#67)
olavandeira May 1, 2025
5a7ad86
remove api.openapi (#68)
olavandeira May 1, 2025
0c44678
Add mfa method to post accounts
arun-singh Jul 14, 2025
3920e87
Add client configuration endpoint docs
jakewherlock1 Sep 9, 2025
1f2d2ef
Improve docs after changing functionality, remove unnecessary info
jakewherlock1 Sep 9, 2025
e9ab8a6
Make wording clearer based on review comments
jakewherlock1 Sep 10, 2025
82213b2
Add docs for api-keys endpoint (#79)
jakewherlock1 Sep 15, 2025
fba625f
Merge branch 'main' into feature-436-add-client-configuration-docs
jakewherlock1 Sep 25, 2025
f21d609
Fix merge conflict break
jakewherlock1 Sep 25, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .DS_Store
Binary file not shown.
4 changes: 4 additions & 0 deletions api-reference/accounts/create.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Create an account'
openapi: 'POST /accounts'
---
4 changes: 4 additions & 0 deletions api-reference/accounts/delete.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Delete an account'
openapi: 'DELETE /accounts/{account_id}'
---
4 changes: 4 additions & 0 deletions api-reference/accounts/get.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Get an account'
openapi: 'GET /accounts/{account_id}'
---
4 changes: 4 additions & 0 deletions api-reference/accounts/list-recurring.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'List all recurring accounts'
openapi: 'GET /accounts/recurring'
---
4 changes: 4 additions & 0 deletions api-reference/accounts/list.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'List all accounts'
openapi: 'GET /accounts'
---
4 changes: 4 additions & 0 deletions api-reference/api-keys/create.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Create an API Key'
openapi: 'POST /api-keys'
---
4 changes: 4 additions & 0 deletions api-reference/api-keys/delete.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Delete an API Key'
openapi: 'DELETE /api-keys/{api_key_id}'
---
4 changes: 4 additions & 0 deletions api-reference/api-keys/list.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'List API Keys'
openapi: 'GET /api-keys'
---
6 changes: 6 additions & 0 deletions api-reference/configuration/get.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: 'Get client configuration'
openapi: 'GET /configuration'
---


6 changes: 6 additions & 0 deletions api-reference/configuration/update.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: 'Update client configuration'
openapi: 'PUT /configuration'
---


4 changes: 4 additions & 0 deletions api-reference/documents/delete.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Delete a document'
openapi: 'DELETE /documents/{document_id}'
---
4 changes: 4 additions & 0 deletions api-reference/documents/get.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Retrieve a specific document'
openapi: 'GET /documents/{document_id}'
---
4 changes: 4 additions & 0 deletions api-reference/documents/list.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Lists all documents'
openapi: 'GET /documents'
---
4 changes: 0 additions & 4 deletions api-reference/endpoint/create.mdx

This file was deleted.

4 changes: 0 additions & 4 deletions api-reference/endpoint/delete.mdx

This file was deleted.

4 changes: 0 additions & 4 deletions api-reference/endpoint/get.mdx

This file was deleted.

4 changes: 4 additions & 0 deletions api-reference/entries/connections-create.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Create a connection'
openapi: 'POST /entries/connections'
---
4 changes: 4 additions & 0 deletions api-reference/entries/delete.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Delete an entry'
openapi: 'DELETE /entries/{entry_id}'
---
4 changes: 4 additions & 0 deletions api-reference/entries/list.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'List all entries'
openapi: 'GET /entries'
---
199 changes: 199 additions & 0 deletions api-reference/entries/payslips-create.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,199 @@
---
title: 'Upload payslips'
openapi: 'POST /entries/payslips'
---



<RequestExample>

```bash cURL
curl --request POST \
--url https://api.sandbox.goteal.co/entries/payslips \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'payslip123456=@"/local/file/file1-payslip.pdf"'
--form 'payslip2=@"/local/file/John-Smith-payslip18.pdf.pdf"'
--form 'payslip98765=@"/local/file/Payslip3.pdf"'
```

```python Python
import requests

url = "https://api.sandbox.goteal.co/entries/payslips"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payslip\"\r\n\r\n@\"/local/file/system/path/to/payslip/Payslip_44404148.pdf\"\n\r\n-----011000010111000001101001--\r\n\r\n"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "multipart/form-data"
}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

```


```javascript JavaScript
const form = new FormData();
form.append("payslip", "@\"/local/file/system/path/to/payslip/Payslip_44404148.pdf\"\n");

const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'multipart/form-data'}
};

options.body = form;

fetch('https://api.sandbox.goteal.co/entries/payslips', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```


```php PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.goteal.co/entries/payslips",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payslip\"\r\n\r\n@\"/local/file/system/path/to/payslip/Payslip_44404148.pdf\"\n\r\n-----011000010111000001101001--\r\n\r\n",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: multipart/form-data"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
```



```go Go
package main

import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)

func main() {

url := "https://api.sandbox.goteal.co/entries/payslips"

payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payslip\"\r\n\r\n@\"/local/file/system/path/to/payslip/Payslip_44404148.pdf\"\n\r\n-----011000010111000001101001--\r\n\r\n")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "multipart/form-data")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)

fmt.Println(res)
fmt.Println(string(body))

}
```



```java Java
HttpResponse<String> response = Unirest.post("https://api.sandbox.goteal.co/entries/payslips")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "multipart/form-data")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payslip\"\r\n\r\n@\"/local/file/system/path/to/payslip/Payslip_44404148.pdf\"\n\r\n-----011000010111000001101001--\r\n\r\n")
.asString();
```

</RequestExample>

<ResponseExample>

```json Response
{
"account_id": "95a0e70b-fe02-4f47-aef9-2efff279df71",
"entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payroll_submissions": [
{
"id": "95a0e70b-fe02-4f47-aef9-2efff279df71",
"account_id": "674744df-9626-47ef-ae2b-4a491be136b5",
"entry_id": "be770ba4-1362-46cd-8c1c-2330ce3a8b69",
"created_at": "2019-05-17T00:00:00.000Z",
"document_external_id": "payslip123456",
"document_filename": "file1-payslip.pdf",
"identity_information": {
"name": "John Smith",
"date_of_birth": "2019-05-17T00:00:00.000Z",
"address": {
"street": "123 Main Street",
"county": "Greater London",
"city": "London",
"post_code": "SW1A 1AA",
"country": "United Kingdom"
},
"email": "john.smith@company.com",
"phone": 447123456789,
"NI_number": "AB123456C"
},
"employment_information": {
"employer_name": "Acme Ltd",
"role": "Software Engineer",
"type": "Full-time",
"status": "Active",
"start_date": "2019-05-17T00:00:00.000Z",
"leave_date": "2019-05-17T00:00:00.000Z"
},
"income_information": {
"pay_date": "2023-05-27T00:00:00.000Z",
"pay_interval_start": "2023-05-01T00:00:00.000Z",
"pay_interval_end": "2023-05-31T00:00:00.000Z",
"pay_frequency": "Monthly",
"earnings": {
"gross_pay": 3500,
"net_pay": 2500,
"base_salary": 3000,
"bonus": 500
},
"deductions": {
"income_tax": 500,
"employee_ni": 200,
"employee_pension": 300,
"total_deductions": 1000
}
}
},
"fraud_risk": "Low"
],
"payslip_errors" : [{
"error" : "File is not a payslip",
"file_name" : "Payslip3.pdf"
}]
}
```

</ResponseExample>

33 changes: 0 additions & 33 deletions api-reference/introduction.mdx

This file was deleted.

4 changes: 4 additions & 0 deletions api-reference/members/create.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Invite a Member'
openapi: 'POST /members'
---
4 changes: 4 additions & 0 deletions api-reference/members/delete.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Delete a Member'
openapi: 'DELETE /members/{member_id}'
---
4 changes: 4 additions & 0 deletions api-reference/members/get.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Retrieve a Member'
openapi: 'GET /members/{member_id}'
---
4 changes: 4 additions & 0 deletions api-reference/members/list.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'List all Members'
openapi: 'GET /members'
---
4 changes: 4 additions & 0 deletions api-reference/members/signin.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: 'Member Sigin In'
openapi: 'POST /members/signin'
---
Loading