feat(api): api update

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 254
-openapi_spec_hash: 55fb271eb29805e8a49ed72fb5ed8843
+openapi_spec_hash: e26db9a4f5055fc4534007aa9c4eaea8
 config_hash: f0e1844d06c76a9e145f7986d993dda6

src/AccountStatements/AccountStatement.php

@@ -76,13 +76,13 @@ final class AccountStatement implements BaseModel
     public int $startingBalance;
 
     /**
-     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the end of the period the Account Statement covers. The statement covers all transactions up to, but not including this timestamp. Usually, this is the beginning of the following month.
+     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the end of the period the Account Statement covers. The statement covers all transactions up to, but not including this timestamp. Statement periods are measured in UTC days, so this is usually midnight UTC on the first day of the following month.
      */
     #[Required('statement_period_end')]
     public \DateTimeInterface $statementPeriodEnd;
 
     /**
-     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the start of the period the Account Statement covers. This is the first moment of the statement period and is inclusive. Usually, this is the beginning of the month this statement covers.
+     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the start of the period the Account Statement covers. This is the first moment of the statement period and is inclusive. Statement periods are measured in UTC days, so this is usually midnight UTC on the first day of the month this statement covers.
      */
     #[Required('statement_period_start')]
     public \DateTimeInterface $statementPeriodStart;
@@ -251,7 +251,7 @@ public function withStartingBalance(int $startingBalance): self
     }
 
     /**
-     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the end of the period the Account Statement covers. The statement covers all transactions up to, but not including this timestamp. Usually, this is the beginning of the following month.
+     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the end of the period the Account Statement covers. The statement covers all transactions up to, but not including this timestamp. Statement periods are measured in UTC days, so this is usually midnight UTC on the first day of the following month.
      */
     public function withStatementPeriodEnd(
         \DateTimeInterface $statementPeriodEnd
@@ -263,7 +263,7 @@ public function withStatementPeriodEnd(
     }
 
     /**
-     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the start of the period the Account Statement covers. This is the first moment of the statement period and is inclusive. Usually, this is the beginning of the month this statement covers.
+     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time representing the start of the period the Account Statement covers. This is the first moment of the statement period and is inclusive. Statement periods are measured in UTC days, so this is usually midnight UTC on the first day of the month this statement covers.
      */
     public function withStatementPeriodStart(
         \DateTimeInterface $statementPeriodStart

src/Exports/Export/AccountStatementBai2.php

@@ -27,7 +27,7 @@ final class AccountStatementBai2 implements BaseModel
     public ?string $accountID;
 
     /**
-     * The date for which to retrieve the balance.
+     * The UTC date for which to retrieve the balance.
      */
     #[Required('effective_date')]
     public ?string $effectiveDate;
@@ -91,7 +91,7 @@ public function withAccountID(?string $accountID): self
     }
 
     /**
-     * The date for which to retrieve the balance.
+     * The UTC date for which to retrieve the balance.
      */
     public function withEffectiveDate(?string $effectiveDate): self
     {

src/Exports/Export/AccountVerificationLetter.php

@@ -27,7 +27,7 @@ final class AccountVerificationLetter implements BaseModel
     public string $accountNumberID;
 
     /**
-     * The date of the balance to include in the letter.
+     * The UTC date of the balance to include in the letter.
      */
     #[Required('balance_date')]
     public ?string $balanceDate;
@@ -80,7 +80,7 @@ public function withAccountNumberID(string $accountNumberID): self
     }
 
     /**
-     * The date of the balance to include in the letter.
+     * The UTC date of the balance to include in the letter.
      */
     public function withBalanceDate(?string $balanceDate): self
     {

src/Exports/Export/BookkeepingAccountBalanceCsv.php

@@ -29,13 +29,13 @@ final class BookkeepingAccountBalanceCsv implements BaseModel
     public ?string $bookkeepingAccountID;
 
     /**
-     * Filter balances to those on or after this date.
+     * Filter balances to those on or after this UTC date.
      */
     #[Required('on_or_after_date')]
     public ?string $onOrAfterDate;
 
     /**
-     * Filter balances to those on or before this date.
+     * Filter balances to those on or before this UTC date.
      */
     #[Required('on_or_before_date')]
     public ?string $onOrBeforeDate;
@@ -96,7 +96,7 @@ public function withBookkeepingAccountID(
     }
 
     /**
-     * Filter balances to those on or after this date.
+     * Filter balances to those on or after this UTC date.
      */
     public function withOnOrAfterDate(?string $onOrAfterDate): self
     {
@@ -107,7 +107,7 @@ public function withOnOrAfterDate(?string $onOrAfterDate): self
     }
 
     /**
-     * Filter balances to those on or before this date.
+     * Filter balances to those on or before this UTC date.
      */
     public function withOnOrBeforeDate(?string $onOrBeforeDate): self
     {

src/Exports/Export/DailyAccountBalanceCsv.php

@@ -29,13 +29,13 @@ final class DailyAccountBalanceCsv implements BaseModel
     public ?string $accountID;
 
     /**
-     * Filter balances on or after this date.
+     * Filter balances on or after this UTC date.
      */
     #[Required('on_or_after_date')]
     public ?string $onOrAfterDate;
 
     /**
-     * Filter balances on or before this date.
+     * Filter balances on or before this UTC date.
      */
     #[Required('on_or_before_date')]
     public ?string $onOrBeforeDate;
@@ -95,7 +95,7 @@ public function withAccountID(?string $accountID): self
     }
 
     /**
-     * Filter balances on or after this date.
+     * Filter balances on or after this UTC date.
      */
     public function withOnOrAfterDate(?string $onOrAfterDate): self
     {
@@ -106,7 +106,7 @@ public function withOnOrAfterDate(?string $onOrAfterDate): self
     }
 
     /**
-     * Filter balances on or before this date.
+     * Filter balances on or before this UTC date.
      */
     public function withOnOrBeforeDate(?string $onOrBeforeDate): self
     {

src/Exports/ExportCreateParams/AccountStatementBai2.php

@@ -27,7 +27,7 @@ final class AccountStatementBai2 implements BaseModel
     public ?string $accountID;
 
     /**
-     * The date to create a BAI2 report for. If not provided, the current date will be used. The timezone is UTC. If the current date is used, the report will include intraday balances, otherwise it will include end-of-day balances for the provided date.
+     * The UTC date to create a BAI2 report for. If not provided, the current date will be used. If the current date is used, the report will include intraday balances, otherwise it will include end-of-day balances for the provided date.
      */
     #[Optional('effective_date')]
     public ?string $effectiveDate;
@@ -74,7 +74,7 @@ public function withAccountID(string $accountID): self
     }
 
     /**
-     * The date to create a BAI2 report for. If not provided, the current date will be used. The timezone is UTC. If the current date is used, the report will include intraday balances, otherwise it will include end-of-day balances for the provided date.
+     * The UTC date to create a BAI2 report for. If not provided, the current date will be used. If the current date is used, the report will include intraday balances, otherwise it will include end-of-day balances for the provided date.
      */
     public function withEffectiveDate(string $effectiveDate): self
     {

src/Exports/ExportCreateParams/AccountVerificationLetter.php

@@ -28,7 +28,7 @@ final class AccountVerificationLetter implements BaseModel
     public string $accountNumberID;
 
     /**
-     * The date of the balance to include in the letter. Defaults to the current date.
+     * The UTC date of the balance to include in the letter. Defaults to the current date.
      */
     #[Optional('balance_date')]
     public ?string $balanceDate;
@@ -82,7 +82,7 @@ public function withAccountNumberID(string $accountNumberID): self
     }
 
     /**
-     * The date of the balance to include in the letter. Defaults to the current date.
+     * The UTC date of the balance to include in the letter. Defaults to the current date.
      */
     public function withBalanceDate(string $balanceDate): self
     {

src/Exports/ExportCreateParams/BookkeepingAccountBalanceCsv.php

@@ -29,13 +29,13 @@ final class BookkeepingAccountBalanceCsv implements BaseModel
     public ?string $bookkeepingAccountID;
 
     /**
-     * Filter exported Balances to those on or after this date.
+     * Filter exported Balances to those on or after this UTC date.
      */
     #[Optional('on_or_after_date')]
     public ?string $onOrAfterDate;
 
     /**
-     * Filter exported Balances to those on or before this date.
+     * Filter exported Balances to those on or before this UTC date.
      */
     #[Optional('on_or_before_date')]
     public ?string $onOrBeforeDate;
@@ -76,7 +76,7 @@ public function withBookkeepingAccountID(string $bookkeepingAccountID): self
     }
 
     /**
-     * Filter exported Balances to those on or after this date.
+     * Filter exported Balances to those on or after this UTC date.
      */
     public function withOnOrAfterDate(string $onOrAfterDate): self
     {
@@ -87,7 +87,7 @@ public function withOnOrAfterDate(string $onOrAfterDate): self
     }
 
     /**
-     * Filter exported Balances to those on or before this date.
+     * Filter exported Balances to those on or before this UTC date.
      */
     public function withOnOrBeforeDate(string $onOrBeforeDate): self
     {

src/Exports/ExportCreateParams/DailyAccountBalanceCsv.php

@@ -29,13 +29,13 @@ final class DailyAccountBalanceCsv implements BaseModel
     public ?string $accountID;
 
     /**
-     * Filter exported Balances to those on or after this date.
+     * Filter exported Balances to those on or after this UTC date.
      */
     #[Optional('on_or_after_date')]
     public ?string $onOrAfterDate;
 
     /**
-     * Filter exported Balances to those on or before this date.
+     * Filter exported Balances to those on or before this UTC date.
      */
     #[Optional('on_or_before_date')]
     public ?string $onOrBeforeDate;
@@ -76,7 +76,7 @@ public function withAccountID(string $accountID): self
     }
 
     /**
-     * Filter exported Balances to those on or after this date.
+     * Filter exported Balances to those on or after this UTC date.
      */
     public function withOnOrAfterDate(string $onOrAfterDate): self
     {
@@ -87,7 +87,7 @@ public function withOnOrAfterDate(string $onOrAfterDate): self
     }
 
     /**
-     * Filter exported Balances to those on or before this date.
+     * Filter exported Balances to those on or before this UTC date.
      */
     public function withOnOrBeforeDate(string $onOrBeforeDate): self
     {

src/InboundFednowTransfers/InboundFednowTransfer.php

@@ -33,6 +33,7 @@
  *   debtorRoutingNumber: string,
  *   decline: null|Decline|DeclineShape,
  *   endToEndIdentification: string|null,
+ *   messageIdentification: string,
  *   status: Status|value-of<Status>,
  *   transactionID: string|null,
  *   transactionIdentification: string|null,
@@ -126,6 +127,12 @@ final class InboundFednowTransfer implements BaseModel
     #[Required('end_to_end_identification')]
     public ?string $endToEndIdentification;
 
+    /**
+     * The FedNow network identification of the transfer.
+     */
+    #[Required('message_identification')]
+    public string $messageIdentification;
+
     /**
      * The lifecycle status of the transfer.
      *
@@ -141,7 +148,7 @@ final class InboundFednowTransfer implements BaseModel
     public ?string $transactionID;
 
     /**
-     * The FedNow network identification of the transfer.
+     * An optional identifier for the transfer set by the sending bank.
      */
     #[Required('transaction_identification')]
     public ?string $transactionIdentification;
@@ -185,6 +192,7 @@ final class InboundFednowTransfer implements BaseModel
      *   debtorRoutingNumber: ...,
      *   decline: ...,
      *   endToEndIdentification: ...,
+     *   messageIdentification: ...,
      *   status: ...,
      *   transactionID: ...,
      *   transactionIdentification: ...,
@@ -211,6 +219,7 @@ final class InboundFednowTransfer implements BaseModel
      *   ->withDebtorRoutingNumber(...)
      *   ->withDecline(...)
      *   ->withEndToEndIdentification(...)
+     *   ->withMessageIdentification(...)
      *   ->withStatus(...)
      *   ->withTransactionID(...)
      *   ->withTransactionIdentification(...)
@@ -249,6 +258,7 @@ public static function with(
         string $debtorRoutingNumber,
         Decline|array|null $decline,
         ?string $endToEndIdentification,
+        string $messageIdentification,
         Status|string $status,
         ?string $transactionID,
         ?string $transactionIdentification,
@@ -271,6 +281,7 @@ public static function with(
         $self['debtorRoutingNumber'] = $debtorRoutingNumber;
         $self['decline'] = $decline;
         $self['endToEndIdentification'] = $endToEndIdentification;
+        $self['messageIdentification'] = $messageIdentification;
         $self['status'] = $status;
         $self['transactionID'] = $transactionID;
         $self['transactionIdentification'] = $transactionIdentification;
@@ -432,6 +443,18 @@ public function withEndToEndIdentification(
         return $self;
     }
 
+    /**
+     * The FedNow network identification of the transfer.
+     */
+    public function withMessageIdentification(
+        string $messageIdentification
+    ): self {
+        $self = clone $this;
+        $self['messageIdentification'] = $messageIdentification;
+
+        return $self;
+    }
+
     /**
      * The lifecycle status of the transfer.
      *
@@ -457,7 +480,7 @@ public function withTransactionID(?string $transactionID): self
     }
 
     /**
-     * The FedNow network identification of the transfer.
+     * An optional identifier for the transfer set by the sending bank.
      */
     public function withTransactionIdentification(
         ?string $transactionIdentification

src/Services/FilesRawService.php

@@ -68,7 +68,7 @@ public function create(
     /**
      * @api
      *
-     * Retrieve a File
+     * Fetch metadata about a File, like its `purpose` and MIME type. To access the content, use the [Get File contents](/documentation/api/files#get-file-contents) API.
      *
      * @param string $fileID the identifier of the File
      * @param RequestOpts|null $requestOptions

src/Services/FilesService.php

@@ -68,7 +68,7 @@ public function create(
     /**
      * @api
      *
-     * Retrieve a File
+     * Fetch metadata about a File, like its `purpose` and MIME type. To access the content, use the [Get File contents](/documentation/api/files#get-file-contents) API.
      *
      * @param string $fileID the identifier of the File
      * @param RequestOpts|null $requestOptions