Skip to content

release: 2.0.0 #396

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
stainless-app merged 2 commits into from
Jun 22, 2026
Merged

release: 2.0.0 #396

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c563bff
fix(payroll): pay_statement_item is now a direct subresource of hris …
stainless-app[bot] Jun 22, 2026
6570163
release: 2.0.0
stainless-app[bot] Jun 22, 2026
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
2 changes: 1 addition & 1 deletion .release-please-manifest.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "1.38.0"
".": "2.0.0"
}
4 changes: 2 additions & 2 deletions .stats.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 48
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-7e39b6a20bf3e1f23ad832300b73ae92b6f6ce7c9d86eaa8fcc0710b51455f17.yml
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-ecd3f6c28edae07dbe9f54d8040a6d7f2af5ac032b20f8df06065542478e4e73.yml
openapi_spec_hash: 5e0e04e7274494062ff46ac85d358f5b
config_hash: 8b3c2a32014346513c18d98cbb752d2c
config_hash: 9ae56f40cec7304896138bfad5caf748
8 changes: 8 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# Changelog

## 2.0.0 (2026-06-22)

Full Changelog: [v1.38.0...v2.0.0](https://github.com/Finch-API/finch-api-go/compare/v1.38.0...v2.0.0)

### Bug Fixes

* **payroll:** pay_statement_item is now a direct subresource of hris instead of company ([c563bff](https://github.com/Finch-API/finch-api-go/commit/c563bff01e615514b40745e2d888591d1dbe0035))

## 1.38.0 (2026-06-22)

Full Changelog: [v1.37.0...v1.38.0](https://github.com/Finch-API/finch-api-go/compare/v1.37.0...v1.38.0)
Expand Down
10 changes: 5 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Finch Go API Library

<a href="https://pkg.go.dev/github.com/Finch-API/finch-api-go"><img src="https://pkg.go.dev/badge/github.com/Finch-API/finch-api-go.svg" alt="Go Reference"></a>
<a href="https://pkg.go.dev/github.com/Finch-API/finch-api-go/v2"><img src="https://pkg.go.dev/badge/github.com/Finch-API/finch-api-go.svg" alt="Go Reference"></a>

The Finch Go library provides convenient access to the [Finch REST API](https://developer.tryfinch.com/)
from applications written in Go.
Expand All @@ -22,7 +22,7 @@ Use the Finch MCP Server to enable AI assistants to interact with this API, allo

```go
import (
"github.com/Finch-API/finch-api-go" // imported as finchgo
"github.com/Finch-API/finch-api-go/v2" // imported as finchgo
)
```

Expand All @@ -33,7 +33,7 @@ Or to pin the version:
<!-- x-release-please-start-version -->

```sh
go get -u 'github.com/Finch-API/finch-api-go@v1.38.0'
go get -u 'github.com/Finch-API/finch-api-go@v2.0.0'
```

<!-- x-release-please-end -->
Expand All @@ -53,8 +53,8 @@ import (
"context"
"fmt"

"github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/option"
)

func main() {
Expand Down
8 changes: 4 additions & 4 deletions accesstoken.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@ import (
"net/http"
"slices"

"github.com/Finch-API/finch-api-go/internal/apijson"
"github.com/Finch-API/finch-api-go/internal/param"
"github.com/Finch-API/finch-api-go/internal/requestconfig"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2/internal/apijson"
"github.com/Finch-API/finch-api-go/v2/internal/param"
"github.com/Finch-API/finch-api-go/v2/internal/requestconfig"
"github.com/Finch-API/finch-api-go/v2/option"
"github.com/tidwall/gjson"
"github.com/tidwall/sjson"
)
Expand Down
6 changes: 3 additions & 3 deletions accesstoken_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ import (
"os"
"testing"

"github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/internal/testutil"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/internal/testutil"
"github.com/Finch-API/finch-api-go/v2/option"
)

func TestAccessTokenNewWithOptionalParams(t *testing.T) {
Expand Down
10 changes: 5 additions & 5 deletions account.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ import (
"reflect"
"slices"

"github.com/Finch-API/finch-api-go/internal/apijson"
"github.com/Finch-API/finch-api-go/internal/param"
"github.com/Finch-API/finch-api-go/internal/requestconfig"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/shared"
"github.com/Finch-API/finch-api-go/v2/internal/apijson"
"github.com/Finch-API/finch-api-go/v2/internal/param"
"github.com/Finch-API/finch-api-go/v2/internal/requestconfig"
"github.com/Finch-API/finch-api-go/v2/option"
"github.com/Finch-API/finch-api-go/v2/shared"
"github.com/tidwall/gjson"
)

Expand Down
6 changes: 3 additions & 3 deletions account_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ import (
"os"
"testing"

"github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/internal/testutil"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/internal/testutil"
"github.com/Finch-API/finch-api-go/v2/option"
)

func TestAccountDisconnect(t *testing.T) {
Expand Down
4 changes: 2 additions & 2 deletions aliases.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
package finchgo

import (
"github.com/Finch-API/finch-api-go/internal/apierror"
"github.com/Finch-API/finch-api-go/shared"
"github.com/Finch-API/finch-api-go/v2/internal/apierror"
"github.com/Finch-API/finch-api-go/v2/shared"
)

type Error = apierror.Error
Expand Down
272 changes: 136 additions & 136 deletions api.md
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions client.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ import (
"slices"
"strings"

"github.com/Finch-API/finch-api-go/internal/requestconfig"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2/internal/requestconfig"
"github.com/Finch-API/finch-api-go/v2/option"
)

// Client creates a struct with services and top level methods that help with
Expand Down
6 changes: 3 additions & 3 deletions client_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ import (
"testing"
"time"

"github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/internal"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/internal"
"github.com/Finch-API/finch-api-go/v2/option"
)

type closureTransport struct {
Expand Down
2 changes: 1 addition & 1 deletion connect.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
package finchgo

import (
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2/option"
)

// ConnectService contains methods and other services that help with interacting
Expand Down
8 changes: 4 additions & 4 deletions connectsession.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@ import (
"net/http"
"slices"

"github.com/Finch-API/finch-api-go/internal/apijson"
"github.com/Finch-API/finch-api-go/internal/param"
"github.com/Finch-API/finch-api-go/internal/requestconfig"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2/internal/apijson"
"github.com/Finch-API/finch-api-go/v2/internal/param"
"github.com/Finch-API/finch-api-go/v2/internal/requestconfig"
"github.com/Finch-API/finch-api-go/v2/option"
)

// ConnectSessionService contains methods and other services that help with
Expand Down
6 changes: 3 additions & 3 deletions connectsession_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ import (
"os"
"testing"

"github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/internal/testutil"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/internal/testutil"
"github.com/Finch-API/finch-api-go/v2/option"
)

func TestConnectSessionNewWithOptionalParams(t *testing.T) {
Expand Down
4 changes: 2 additions & 2 deletions examples/auth/main.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ import (
"context"
"fmt"

finch "github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/option"
finch "github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/option"
)

func main() {
Expand Down
2 changes: 1 addition & 1 deletion field.go
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
package finchgo

import (
"github.com/Finch-API/finch-api-go/internal/param"
"github.com/Finch-API/finch-api-go/v2/internal/param"
"io"
)

Expand Down
2 changes: 1 addition & 1 deletion go.mod
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
module github.com/Finch-API/finch-api-go
module github.com/Finch-API/finch-api-go/v2

go 1.22

Expand Down
26 changes: 14 additions & 12 deletions hris.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@ package finchgo
import (
"time"

"github.com/Finch-API/finch-api-go/internal/apijson"
"github.com/Finch-API/finch-api-go/internal/param"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2/internal/apijson"
"github.com/Finch-API/finch-api-go/v2/internal/param"
"github.com/Finch-API/finch-api-go/v2/option"
)

// HRISService contains methods and other services that help with interacting with
Expand All @@ -17,15 +17,16 @@ import (
// automatically. You should not instantiate this service directly, and instead use
// the [NewHRISService] method instead.
type HRISService struct {
Options []option.RequestOption
Company *HRISCompanyService
Directory *HRISDirectoryService
Individuals *HRISIndividualService
Employments *HRISEmploymentService
Payments *HRISPaymentService
PayStatements *HRISPayStatementService
Documents *HRISDocumentService
Benefits *HRISBenefitService
Options []option.RequestOption
Company *HRISCompanyService
PayStatementItem *HRISPayStatementItemService
Directory *HRISDirectoryService
Individuals *HRISIndividualService
Employments *HRISEmploymentService
Payments *HRISPaymentService
PayStatements *HRISPayStatementService
Documents *HRISDocumentService
Benefits *HRISBenefitService
}

// NewHRISService generates a new service that applies the given options to each
Expand All @@ -35,6 +36,7 @@ func NewHRISService(opts ...option.RequestOption) (r *HRISService) {
r = &HRISService{}
r.Options = opts
r.Company = NewHRISCompanyService(opts...)
r.PayStatementItem = NewHRISPayStatementItemService(opts...)
r.Directory = NewHRISDirectoryService(opts...)
r.Individuals = NewHRISIndividualService(opts...)
r.Employments = NewHRISEmploymentService(opts...)
Expand Down
14 changes: 7 additions & 7 deletions hrisbenefit.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,13 @@ import (
"net/url"
"slices"

"github.com/Finch-API/finch-api-go/internal/apijson"
"github.com/Finch-API/finch-api-go/internal/apiquery"
"github.com/Finch-API/finch-api-go/internal/param"
"github.com/Finch-API/finch-api-go/internal/requestconfig"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/packages/pagination"
"github.com/Finch-API/finch-api-go/shared"
"github.com/Finch-API/finch-api-go/v2/internal/apijson"
"github.com/Finch-API/finch-api-go/v2/internal/apiquery"
"github.com/Finch-API/finch-api-go/v2/internal/param"
"github.com/Finch-API/finch-api-go/v2/internal/requestconfig"
"github.com/Finch-API/finch-api-go/v2/option"
"github.com/Finch-API/finch-api-go/v2/packages/pagination"
"github.com/Finch-API/finch-api-go/v2/shared"
)

// HRISBenefitService contains methods and other services that help with
Expand Down
6 changes: 3 additions & 3 deletions hrisbenefit_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ import (
"os"
"testing"

"github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/internal/testutil"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/internal/testutil"
"github.com/Finch-API/finch-api-go/v2/option"
)

func TestHRISBenefitNewWithOptionalParams(t *testing.T) {
Expand Down
12 changes: 6 additions & 6 deletions hrisbenefitindividual.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,12 @@ import (
"slices"
"time"

"github.com/Finch-API/finch-api-go/internal/apijson"
"github.com/Finch-API/finch-api-go/internal/apiquery"
"github.com/Finch-API/finch-api-go/internal/param"
"github.com/Finch-API/finch-api-go/internal/requestconfig"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/packages/pagination"
"github.com/Finch-API/finch-api-go/v2/internal/apijson"
"github.com/Finch-API/finch-api-go/v2/internal/apiquery"
"github.com/Finch-API/finch-api-go/v2/internal/param"
"github.com/Finch-API/finch-api-go/v2/internal/requestconfig"
"github.com/Finch-API/finch-api-go/v2/option"
"github.com/Finch-API/finch-api-go/v2/packages/pagination"
"github.com/tidwall/gjson"
)

Expand Down
6 changes: 3 additions & 3 deletions hrisbenefitindividual_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ import (
"testing"
"time"

"github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/internal/testutil"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/internal/testutil"
"github.com/Finch-API/finch-api-go/v2/option"
)

func TestHRISBenefitIndividualEnrollManyWithOptionalParams(t *testing.T) {
Expand Down
14 changes: 6 additions & 8 deletions hriscompany.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ import (
"net/url"
"slices"

"github.com/Finch-API/finch-api-go/internal/apijson"
"github.com/Finch-API/finch-api-go/internal/apiquery"
"github.com/Finch-API/finch-api-go/internal/param"
"github.com/Finch-API/finch-api-go/internal/requestconfig"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2/internal/apijson"
"github.com/Finch-API/finch-api-go/v2/internal/apiquery"
"github.com/Finch-API/finch-api-go/v2/internal/param"
"github.com/Finch-API/finch-api-go/v2/internal/requestconfig"
"github.com/Finch-API/finch-api-go/v2/option"
)

// HRISCompanyService contains methods and other services that help with
Expand All @@ -22,8 +22,7 @@ import (
// automatically. You should not instantiate this service directly, and instead use
// the [NewHRISCompanyService] method instead.
type HRISCompanyService struct {
Options []option.RequestOption
PayStatementItem *HRISCompanyPayStatementItemService
Options []option.RequestOption
}

// NewHRISCompanyService generates a new service that applies the given options to
Expand All @@ -32,7 +31,6 @@ type HRISCompanyService struct {
func NewHRISCompanyService(opts ...option.RequestOption) (r *HRISCompanyService) {
r = &HRISCompanyService{}
r.Options = opts
r.PayStatementItem = NewHRISCompanyPayStatementItemService(opts...)
return
}

Expand Down
6 changes: 3 additions & 3 deletions hriscompany_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ import (
"os"
"testing"

"github.com/Finch-API/finch-api-go"
"github.com/Finch-API/finch-api-go/internal/testutil"
"github.com/Finch-API/finch-api-go/option"
"github.com/Finch-API/finch-api-go/v2"
"github.com/Finch-API/finch-api-go/v2/internal/testutil"
"github.com/Finch-API/finch-api-go/v2/option"
)

func TestHRISCompanyGetWithOptionalParams(t *testing.T) {
Expand Down
Loading
Loading