---
title: "Create Invoice Pull Requests"
method: POST
path: "/v2/invoice-pull-request"
tags: ["Invoice Pull Request"]
---

# Create Invoice Pull Requests

`POST /v2/invoice-pull-request`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/invoice-pull-request`
- Auth: API key in header `Digital-Signature`

Use this route to create new invoice pull requests.

## Request body

- object
  - `attemptType` string: Define the type of attempt, if it is the first one of a billing cycle or if it is a retry. Options: "default", "retry". Default is "default".
  - `due` string, date-time, required: Expected date of settlement.
  - `invoiceId` string, required: Unique ID of the invoice to be pulled.
  - `subscriptionId` string, required: Unique ID of the invoice pull subscription.
  - `tags` string[]: Array of strings to tag the entity for future queries. All tags will be converted to lowercase.

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/starkbank/apis/stark-bank-api.md) - [All operations](https://skmtc.dev/starkbank/apis/stark-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starkbank/apis/stark-bank-api/revisions/aeff5068a5da?raw)