Billing

Get a billing profile

Get a billing profile by id.

The expand option can be used to include additional information (besides the billing profile) in the response. For example by adding the expand=apps option the apps used by the billing profile will be included in the response.

get/api/v1/billing/profiles/{id}

Path parameters

idstring required

Example:01G65Z755AFWAKHE12NY0CQ9FH

Query parameters

expandBillingProfileExpand[]

Response

The request has succeeded.

createdAtstring date-time required

Timestamp of when the resource was created.

defaultboolean required

Is this the default profile?

deletedAtstring date-time

Timestamp of when the resource was permanently deleted.

descriptionstring

Optional description of the resource. Maximum 1024 characters.

idstring required

A unique identifier for the resource.

metadataMetadata

Set of key-value pairs. Metadata can be used to store additional information about a resource.

namestring required

Human-readable name for the resource. Between 1 and 256 characters.

updatedAtstring date-time required

Timestamp of when the resource was last updated.

Example response

{
  "apps": {
    "invoicing": {
      "createdAt": "2024-01-01T01:01:01.001Z",
      "id": "01G65Z755AFWAKHE12NY0CQ9FH",
      "listing": {
        "capabilities": [
          {
            "description": "Stripe Tax calculates tax portion of the invoices.",
            "key": "stripe_calculate_tax",
            "name": "Calculate Tax",
            "type": "calculateTax"
          },
          {
            "description": "Stripe invoices customers with due amount.",
            "key": "stripe_invoice_customers",
            "name": "Invoice Customers",
            "type": "invoiceCustomers"
          },
          {
            "description": "Stripe payments collects outstanding revenue with Stripe customer's default payment method.",
            "key": "stripe_collect_payments",
            "name": "Collect Payments",
            "type": "collectPayments"
          }
        ],
        "description": "Stripe integration allows you to collect payments with Stripe.",
        "installMethods": [
          "with_oauth2",
          "with_api_key"
        ],
        "name": "Stripe",
        "type": "stripe"
      },
      "livemode": true,
      "maskedAPIKey": "sk_live_************abc",
      "name": "Stripe",
      "status": "ready",
      "stripeAccountId": "acct_123456789",
      "type": "stripe",
      "updatedAt": "2024-01-01T01:01:01.001Z"
    },
    "payment": {
      "createdAt": "2024-01-01T01:01:01.001Z",
      "id": "01G65Z755AFWAKHE12NY0CQ9FH",
      "listing": {
        "capabilities": [
          {
            "description": "Stripe Tax calculates tax portion of the invoices.",
            "key": "stripe_calculate_tax",
            "name": "Calculate Tax",
            "type": "calculateTax"
          },
          {
            "description": "Stripe invoices customers with due amount.",
            "key": "stripe_invoice_customers",
            "name": "Invoice Customers",
            "type": "invoiceCustomers"
          },
          {
            "description": "Stripe payments collects outstanding revenue with Stripe customer's default payment method.",
            "key": "stripe_collect_payments",
            "name": "Collect Payments",
            "type": "collectPayments"
          }
        ],
        "description": "Stripe integration allows you to collect payments with Stripe.",
        "installMethods": [
          "with_oauth2",
          "with_api_key"
        ],
        "name": "Stripe",
        "type": "stripe"
      },
      "livemode": true,
      "maskedAPIKey": "sk_live_************abc",
      "name": "Stripe",
      "status": "ready",
      "stripeAccountId": "acct_123456789",
      "type": "stripe",
      "updatedAt": "2024-01-01T01:01:01.001Z"
    },
    "tax": {
      "createdAt": "2024-01-01T01:01:01.001Z",
      "id": "01G65Z755AFWAKHE12NY0CQ9FH",
      "listing": {
        "capabilities": [
          {
            "description": "Stripe Tax calculates tax portion of the invoices.",
            "key": "stripe_calculate_tax",
            "name": "Calculate Tax",
            "type": "calculateTax"
          },
          {
            "description": "Stripe invoices customers with due amount.",
            "key": "stripe_invoice_customers",
            "name": "Invoice Customers",
            "type": "invoiceCustomers"
          },
          {
            "description": "Stripe payments collects outstanding revenue with Stripe customer's default payment method.",
            "key": "stripe_collect_payments",
            "name": "Collect Payments",
            "type": "collectPayments"
          }
        ],
        "description": "Stripe integration allows you to collect payments with Stripe.",
        "installMethods": [
          "with_oauth2",
          "with_api_key"
        ],
        "name": "Stripe",
        "type": "stripe"
      },
      "livemode": true,
      "maskedAPIKey": "sk_live_************abc",
      "name": "Stripe",
      "status": "ready",
      "stripeAccountId": "acct_123456789",
      "type": "stripe",
      "updatedAt": "2024-01-01T01:01:01.001Z"
    }
  },
  "createdAt": "2024-01-01T01:01:01.001Z",
  "deletedAt": "2024-01-01T01:01:01.001Z",
  "id": "01G65Z755AFWAKHE12NY0CQ9FH",
  "metadata": {
    "externalId": "019142cc-a016-796a-8113-1a942fecd26d"
  },
  "supplier": {
    "addresses": [
      {
        "country": "US"
      }
    ]
  },
  "updatedAt": "2024-01-01T01:01:01.001Z",
  "workflow": {
    "collection": {
      "alignment": {
        "recurringPeriod": {
          "anchor": "2023-01-01T01:01:01.001Z"
        }
      },
      "interval": "P1D"
    },
    "invoicing": {
      "defaultTaxConfig": {
        "stripe": {
          "code": "txcd_10000000"
        },
        "taxCodeId": "01G65Z755AFWAKHE12NY0CQ9FH"
      },
      "draftPeriod": "P1D",
      "dueAfter": "P30D"
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.